提交发稿
POST/openapi/v1/media/orders
需要权限:media:order
一篇内容投 N 家媒体,生成 N 条工单。点数在提交时扣。
⚠️ 提交成功 ≠ 已发布
这个接口落的是待审核队列,不调平台 API。完整链路是:提交 → 平台方审核 → 推送发布 → 回填链接,中间可能被打回。请不要在你的产品里把「调用成功」显示成「已发布」 —— 用「发稿记录」查真实状态。
请求参数
Body 参数
| 参数 | 类型 | 说明 | |
|---|---|---|---|
| content_id | string | 要投的内容 ID | 必填 |
| media_ids | string[] | 投哪几家媒体 | 必填 |
| requirements | integer | 发稿要求 0~4,各平台语义不同,原样透传 | |
| account_rule | integer | 自媒体换号规则 1~3 | |
| article_type | integer | 1 图文 / 2 微头条 / 3 视频 | |
| scheduled_at | string | 期望发布时间 |
响应
下列字段位于 data 之下。
| 字段 | 类型 | 说明 |
|---|---|---|
| order_ids | string[] | 生成的工单 ID |
| total_points | integer | 本次消耗的发布点数 |
| note | string | 提醒:工单已进入待审核队列,尚未推送到平台 |
可能的错误
| code | HTTP | 含义与处置 |
|---|---|---|
| 1002 | 403 | Key 缺少 media:order 权限 |
| 2004 | 402 | 发布点数不足。detail 里带 quota / used / required,可直接算出还差多少 |
| 3001 | 404 | 资源不存在,或不属于你 |
| 3002 | 400 | 内容或媒体不可用 |
