渠道管理/内容发布

创建发布流程

Changed on

接口说明:创建多平台发布 Flow,一次请求可生成多个单平台任务。

调用本接口前,请先确保你已经了解完整发布流程,点击了解完整发布流程。请求体中的 items[n].accountId 必须来自账号列表接口;content.media[n].url 必须是可公网访问的真实媒体 URL,不能直接复制示例中的占位值。推荐先按资源上传教程完成“生成上传签名 → 直传文件 → 确认资源上传”,再填写确认接口返回的 data.url;也可使用其他可被服务端直接访问和解析的真实媒体 URL。链接不可访问或无法解析时会返回 15051(media_unreachable)。publishAt 必须填写未来的 ISO 8601 时间。调用成功后,data.flowId 可用于查询流程详情,data.tasks[n].id 可用于立即发布、重试、取消或修改发布时间。该接口会创建真实发布任务,请确认参数无误后再发送。

额度说明:所有平台合计共享每月 1,000 次免费发布接口调用额度,额度按月刷新。可在国内站 API Key 页面或国际站 API Key 页面查看当前用量和剩余额度。X/Twitter(推特)发布除占用上述额度外,还会产生由 X/Twitter 官方收取的额外费用,详情请查看定价页「社交平台」。超出免费额度后,后续将支持超额 API 请求,按 1.5 积分/次扣费。

post/api/v2/channels/publish/flows

Request

Request body

flowIdstring

外部流水 ID

publishAtstring date-time required

目标发布时间

Response

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

codeinteger required

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

messagestring required

响应消息。

requestIdstring

请求 ID。

timestampinteger

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

Changes

    • 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's property format changed from date-time to no format for status

    • info

      removed the -1.00 enum value from the /// response property for the response status

    • info

      removed the 0.00 enum value from the /// response property for the response status

    • info

      removed the 1.00 enum value from the /// response property for the response status

    • info

      removed the 2.00 enum value from the /// response property for the response status

    • info

      removed the 3.00 enum value from the /// response property for the response status

    • info

      removed the 4.00 enum value from the /// response property for the response status

    • info

      removed the 5.00 enum value from the /// response property for the response status

    • info

      removed the 6.00 enum value from the /// response property for the response status

    • info

      removed the 7.00 enum value from the /// response property for the response status

    • info

      removed the 8.00 enum value from the /// response property for the response status

    • info

      removed the 9.00 enum value from the /// response property for the response status

    • info

      removed the KWAI enum value from the /// response property for the response status

    • info

      removed the bilibili enum value from the /// response property for the response status

    • info

      removed the douyin enum value from the /// response property for the response status

    • info

      removed the facebook enum value from the /// response property for the response status

    • info

      removed the failed enum value from the /// response property for the response status

    • info

      removed the google_business enum value from the /// response property for the response status

    • info

      removed the instagram enum value from the /// response property for the response status

    • info

      removed the linkedin enum value from the /// response property for the response status

    • info

      removed the pending enum value from the /// response property for the response status

    • info

      removed the pinterest enum value from the /// response property for the response status

    • info

      removed the ready enum value from the /// response property for the response status

    • info

      removed the threads enum value from the /// response property for the response status

    • info

      removed the tiktok enum value from the /// response property for the response status

    • info

      removed the twitter enum value from the /// response property for the response status

    • info

      removed the wxGzh enum value from the /// response property for the response status

    • info

      removed the wxSph enum value from the /// response property for the response status

    • info

      removed the xhs enum value from the /// response property for the response status

    • info

      removed the youtube enum value from the /// response property for the response status