daren_project/README_PLATFORM_ACCOUNT_EXTENDED.md

平台账号扩展功能使用指南

本文档介绍平台账号（PlatformAccount）模型的扩展字段和相关API的使用方法。

新增字段说明

平台账号模型新增了以下字段：

字段名称	类型	说明
tags	字符串	账号标签，以逗号分隔的标签列表
profile_image	URL	账号头像URL
last_posting	日期时间	最后发布内容的时间

API接口使用

1. 创建平台账号

在创建平台账号时，可以同时设置标签、头像和最后发布时间。

请求URL: POST /api/operation/platforms/

请求参数:

{
  "operator": 1,
  "platform_name": "youtube",
  "account_name": "test_channel",
  "account_id": "UC12345",
  "status": "active",
  "followers_count": 1000,
  "account_url": "https://youtube.com/test_channel",
  "description": "测试频道描述",
  "tags": "科技,教育,AI",
  "profile_image": "https://example.com/profile.jpg",
  "last_posting": "2023-09-01T10:00:00Z"
}

成功响应:

{
  "code": 200,
  "message": "平台账号创建成功，并已添加到知识库",
  "data": {
    "id": 1,
    "operator": 1,
    "operator_name": "测试运营",
    "platform_name": "youtube",
    "account_name": "test_channel",
    "account_id": "UC12345",
    "status": "active",
    "followers_count": 1000,
    "account_url": "https://youtube.com/test_channel",
    "description": "测试频道描述",
    "tags": "科技,教育,AI",
    "profile_image": "https://example.com/profile.jpg",
    "last_posting": "2023-09-01T10:00:00Z",
    "created_at": "2023-09-01T10:00:00Z",
    "updated_at": "2023-09-01T10:00:00Z",
    "last_login": null
  }
}

2. 更新平台账号资料

除了使用标准的PUT/PATCH方法更新平台账号外，还提供了一个专门用于更新标签、头像和最后发布时间的接口。

请求URL: POST /api/operation/platforms/{id}/update_profile/

请求参数:

{
  "tags": "科技,编程,AI",
  "profile_image": "https://example.com/new_profile.jpg",
  "last_posting": "2023-09-10T15:30:00Z"
}

成功响应:

{
  "code": 200,
  "message": "平台账号资料更新成功",
  "data": {
    "id": 1,
    "operator": 1,
    "operator_name": "测试运营",
    "platform_name": "youtube",
    "account_name": "test_channel",
    "account_id": "UC12345",
    "status": "active",
    "followers_count": 1000,
    "account_url": "https://youtube.com/test_channel",
    "description": "测试频道描述",
    "tags": "科技,编程,AI",
    "profile_image": "https://example.com/new_profile.jpg",
    "last_posting": "2023-09-10T15:30:00Z",
    "created_at": "2023-09-01T10:00:00Z",
    "updated_at": "2023-09-10T15:35:00Z",
    "last_login": null
  }
}

3. 获取平台账号详情

获取平台账号详情时，也会返回标签、头像和最后发布时间信息。

请求URL: GET /api/operation/platforms/{id}/

成功响应:

{
  "code": 200,
  "message": "获取平台账号详情成功",
  "data": {
    "id": 1,
    "operator": 1,
    "operator_name": "测试运营",
    "platform_name": "youtube",
    "account_name": "test_channel",
    "account_id": "UC12345",
    "status": "active",
    "followers_count": 1000,
    "account_url": "https://youtube.com/test_channel",
    "description": "测试频道描述",
    "tags": "科技,编程,AI",
    "profile_image": "https://example.com/new_profile.jpg",
    "last_posting": "2023-09-10T15:30:00Z",
    "created_at": "2023-09-01T10:00:00Z",
    "updated_at": "2023-09-10T15:35:00Z",
    "last_login": null
  }
}

在Apifox中使用的提示

1. 创建平台账号:

   • 使用POST /api/operation/platforms/端点
   • 根据需要添加标签、头像和最后发布时间字段
   • 确保operator字段设置为有效的运营账号ID

2. 更新平台账号资料:

   • 可以使用标准的PUT /api/operation/platforms/{id}/端点更新所有字段
   • 或者使用专门的POST /api/operation/platforms/{id}/update_profile/端点仅更新资料相关字段
   • 日期时间格式应为ISO 8601格式（如2023-09-10T15:30:00Z）

3. 获取平台账号详情:

   • 使用GET /api/operation/platforms/{id}/端点
   • 响应中将包含所有字段，包括新增的标签、头像和最后发布时间