创建发布任务

POST /extension/task

需要 Bearer Token 鉴权。

端点#

POST https://api.multipost.app/extension/task

请求体#

application/json

字段类型必填说明
targetClientIdstring
taskTypeenum(PUBLISH_POST, SCHEDULE_PUBLISH_POST, DRAFT_POST)必须与 taskData 的结构匹配
taskDataPublishPost | SchedulePublishPost | DraftPost

发布已有草稿#

curl -X POST 'https://api.multipost.app/extension/task' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "targetClientId": "cmd5qsrfd00036hsmokswv5ye",
  "taskType": "DRAFT_POST",
  "taskData": {
    "draftId": "cmd5r2t560001itqgy7n7o0tt",
    "platforms": [
      {
        "name": "DYNAMIC_FACEBOOK"
      }
    ]
  }
}'

不传 timestamp 时会立即处理。计划发布请传入 JavaScript 毫秒时间戳,例如通过 Date.now() 计算得到的 13 位整数。

直接发布内容#

{
  "targetClientId": "cmd5qsrfd00036hsmokswv5ye",
  "taskType": "PUBLISH_POST",
  "taskData": {
    "platforms": [{ "name": "DYNAMIC_FACEBOOK" }],
    "isAutoPublish": false,
    "data": {
      "title": "测试内容",
      "content": "这是一条测试内容",
      "images": [],
      "videos": []
    }
  }
}

PUBLISH_POST 不接受 draftId;如需按时间执行直接发布,请使用 SCHEDULE_PUBLISH_POST 并在 taskData.timestamp 中传入毫秒时间戳。

响应#

200 — 成功创建任务

{
  "success": true,
  "data": {
    "taskId": "string",
    "status": "PENDING"
  }
}

400 — 无效的请求数据

{
  "success": false,
  "error": "string"
}

401 — 未授权

{
  "success": false,
  "error": "string"
}