渠道管理/账号

发布选项可选值

接口说明：查询某个已授权渠道账号在指定发布选项字段下的可选值，用于在创建发布任务前让用户选择平台要求的额外参数。

所有平台侧额外参数的查询都使用本接口。典型场景包括 B 站分区 tid、YouTube 分类 categoryId、Threads 地点 location_id、Pinterest Board boardId。

调用流程：先调用「平台发布选项」接口（GET /api/v2/channels/platforms/{platform}/publish-options）查询该平台有哪些额外参数；将返回项中的 field 放到本接口路径参数 field。如果返回项包含 filterSchema，按该 schema 将过滤条件作为本接口 query 参数传入，例如 Threads 地点可传 keyword 或经纬度。

GET

api

channels

accounts

{accountId}

publish-options

{field}

values

发布选项可选值

curl --request GET \
  --url https://aitoearn.cn/api/v2/channels/accounts/{accountId}/publish-options/{field}/values \
  --header 'X-Api-Key: <api-key>'

{
  "code": 0,
  "message": "请求成功",
  "data": {
    "field": "string",
    "valueType": "list",
    "items": {}
  }
}

授权

X-Api-Key

string

header

必填

AiToEarn Open Platform API Key。

路径参数

accountId

string

必填

渠道账号 ID。必须是当前用户已授权的账号，且账号所属平台应与「平台发布选项」接口中查询的平台一致。

field

string

必填

发布选项字段。取值来自「平台发布选项」接口返回的 data[n].field，例如 tid、categoryId、location_id、boardId。

响应

200 - application/json

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

code

integer

必填

业务状态码。0 表示成功，非 0 表示业务错误。

message

string

必填

响应消息。

data

object

Hide child attributes

data.field

string

必填

发布选项字段

data.valueType

enum<string>

必填

取值结构

可用选项:

list,

tree

data.items

object[]

必填

选项列表

requestId

string

请求 ID。

timestamp

integer

错误响应时间戳，Unix 毫秒。

账号授权状态

创建发布选项值

发布选项可选值

curl --request GET \
  --url https://aitoearn.cn/api/v2/channels/accounts/{accountId}/publish-options/{field}/values \
  --header 'X-Api-Key: <api-key>'

{
  "code": 0,
  "message": "请求成功",
  "data": {
    "field": "string",
    "valueType": "list",
    "items": {}
  }
}