内容

改期

改内容的时间。已排期内容改的是真实发布时间(需发布权与排期档凭证,走月配额);草稿改的只是日历上的计划日期。其它状态不可改期。时间必须带时区且不能是过去。

POST/api/v1/posts/{postId}/reschedule

schedule:writeposts:write写档限流Idempotency-Key 可选

鉴权与护栏

请求头 Authorization: Bearer <长期凭证>,凭证在设置页「接入外部系统 → 长期凭证」签发,见鉴权与权限。
凭证需带 scope schedule:write / posts:write(任一即可调用;具体能用哪一档由凭证的发布落点白名单决定);签发者在工作区里的角色也要允许该动作。
限流:写档,每分钟 10 次(按凭证计),超出回 429 并带 Retry-After。
幂等:带 Idempotency-Key 就按它去重,不带也能调。

路径参数

postIdstring必填

内容 id。

请求体(application/json)

scheduledAtdatetime (ISO 8601, with timezone)必填

新的时间。

clientRequestIdstring可选

幂等键(8–128 chars of [A-Za-z0-9_.:-]);推荐放在 Idempotency-Key 请求头,头与 body 都给时以头为准。

响应

成功返回 HTTP 200,信封为 { data, meta };右侧(窄屏在本页末尾)给出了各状态码的示例。所有错误都是 { error: { code, message, params }, meta },按机器码处理而不是按 message 匹配,码表见错误码。

状态码	可能的错误码
400	`invalid_input`
401	`unauthenticated`
402	`plan_limit`
403	`forbidden` / `workspace_not_found`
404	`not_found`
409	`no_account` / `needs_reauth` / `replay`
429	`rate_limited`
500	`internal`
502	`platform_error`
503	`external_writes_off`

示例

请求

curl -X POST "https://popkit.loxily.com/api/v1/posts/pst_01J8ZK3R7QW6M2/reschedule" \
  -H "Authorization: Bearer popkit_it_••••••••" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-2026-09-21-001" \
  -d '{
  "scheduledAt": "2026-09-23T20:00:00+08:00"
}'

响应

成功

{
  "data": {
    "postId": "pst_01J8ZK3R7QW6M2",
    "status": "scheduled",
    "scheduledAt": "2026-09-23T12:00:00.000Z",
    "deepLink": "https://popkit.loxily.com/calendar?post=pst_01J8ZK3R7QW6M2"
  },
  "meta": {
    "requestId": "6a1d0c9e-2b7f-4e3a-8c5d-1f0e9b8a7c67"
  }
}