v1

latestOpenAPI 3.0.12026-07-265535227.4 KB
渠道管理/平台

平台发布选项

接口说明:查询某个平台在发布时是否需要平台专属的额外参数,以及这些参数的字段名、取值结构和创建规则。

返回的每个 data[n] 表示一个额外参数。常见场景包括 B 站分区 tid、YouTube 分类 categoryId、Threads 地点 location_id、Pinterest Board boardId。如果返回空数组,说明该平台当前没有需要通过发布选项接口处理的额外参数。

使用方式:取返回项中的 field,放到「发布选项可选值」接口路径参数 field 中查询可选值;如果返回项包含 filterSchema,按该 schema 将过滤条件作为查询参数传给「发布选项可选值」接口;如果返回项包含 createSchema,说明该字段支持创建新值,可按 createSchema 组织请求体后调用「创建发布选项值」接口。

get/api/v2/channels/platforms/{platform}/publish-options

Path parameters

platformstring required

平台标识。取值来自「平台列表」接口(GET /api/v2/channels/platforms)返回的 data[n].platform

平台标识。取值来自「平台列表」接口(GET /api/v2/channels/platforms)返回的 data[n].platform

Response

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

codeinteger required

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

messagestring required

响应消息。

requestIdstring

请求 ID。

timestampinteger

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