渠道管理/平台

平台发布选项

Changed on

接口说明:查询指定平台在发布时是否需要平台专属的额外参数,以及这些参数的字段名、取值结构和账号要求。

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

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

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

Request

Path parameters

platform'bilibili' | 'youtube' | 'pinterest' | 'twitter' | 'tiktok' | 'facebook' | 'instagram' | 'threads' | 'linkedin' | 'xhs' | 'wxSph' | 'douyin' | 'KWAI' | 'wxGzh' required

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

Example:bilibili

Response

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

codeinteger

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

messagestring

响应消息。

requestIdstring

请求 ID。

timestampinteger

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

Changes

    • breaking

      the path request parameter platform was restricted to a list of enum values

    • breaking

      the response property became optional for the status

    • breaking

      the response property // became optional for the status

    • breaking

      the response property // became optional for the status

    • breaking

      the response property // became optional for the status

    • breaking

      the response property // became optional for the status

    • breaking

      the response property became optional for the status

    • info

      added the new enum value KWAI to the path request parameter platform

    • info

      added the new enum value bilibili to the path request parameter platform

    • info

      added the new enum value douyin to the path request parameter platform

    • info

      added the new enum value facebook to the path request parameter platform

    • info

      added the new enum value instagram to the path request parameter platform

    • info

      added the new enum value linkedin to the path request parameter platform

    • info

      added the new enum value pinterest to the path request parameter platform

    • info

      added the new enum value threads to the path request parameter platform

    • info

      added the new enum value tiktok to the path request parameter platform

    • info

      added the new enum value twitter to the path request parameter platform

    • info

      added the new enum value wxGzh to the path request parameter platform

    • info

      added the new enum value wxSph to the path request parameter platform

    • info

      added the new enum value xhs to the path request parameter platform

    • info

      added the new enum value youtube to the path request parameter platform