popkitpopkitAPI
中EN
评论互动

回复评论

以收到该评论的那个账号的身份回复。这是以工作区名义对外发声,与发布同级:必须带 Idempotency-Key,每分钟最多 5 次。若该评论已有我方回复,默认会被拒并回已有回复摘要(params.reason=already_replied),确认要追加再传 force:true;同一条评论 24 小时内最多接收 3 条我方回复。长度按平台口径(X 280 加权字数等)。

POST/api/v1/comments/{commentId}/replies
comments:write发布档限流Idempotency-Key 必填

鉴权与护栏

  • 请求头 Authorization: Bearer <长期凭证>,凭证在设置页「接入外部系统 → 长期凭证」签发,见 鉴权与权限。
  • 凭证需带 scope comments:write;签发者在工作区里的角色也要允许该动作。
  • 限流:发布档,每分钟 5 次(按凭证计),超出回 429 并带 Retry-After。
  • 幂等:必须带 Idempotency-Key(缺了回 400);同键重试原样回第一次结果并带 meta.replayed: true。

路径参数

commentIdstring必填

评论收件箱返回的评论 id(不是 replyRowId)。

请求体(application/json)

textstring (1–2000)必填

回复正文。

forceboolean可选

该评论已有我方回复时仍要追加。

clientRequestIdstring必填

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

响应

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

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

示例

请求
curl -X POST "https://popkit.loxily.com/api/v1/comments/cmt_01J8ZQ7H2K4W/replies" \
  -H "Authorization: Bearer popkit_it_••••••••" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-2026-09-21-001" \
  -d '{
  "text": "小红书已经以素材包方式支持啦,可以到账号页看看 🙌"
}'
响应
已回复
{
  "data": {
    "commentId": "cmt_01J8ZQ7H2K4W",
    "replyRowId": "cmt_01J8ZR…",
    "platformCommentId": "7412…",
    "platform": "tiktok",
    "text": "小红书已经以素材包方式支持啦,可以到账号页看看 🙌",
    "repliedAt": "2026-09-20T08:02:11.000Z",
    "deepLink": "https://popkit.loxily.com/engagement?comment=cmt_01J8ZQ7H2K4W"
  },
  "meta": {
    "requestId": "6a1d0c9e-2b7f-4e3a-8c5d-1f0e9b8a7c76"
  }
}
MCP 接入文档