文档 API v2decideModerationClaim

decideModerationClaim

裁决一条认领

decision=approve|decline|ban|unban。unban 恢复该认领被隐藏前所处的状态。需要 If-Match，ETag 来自 GET /v2/moderation/claims/{id}。需要 catalog.claim.review 权限。令牌须带 catalog:edit scope。

post/v2/moderation/claims/{id}/decisions

Authorization: Bearer <用户访问令牌>（用户授权后的访问令牌,不是 API 密钥）

参数

参数	类型	位置	说明
`id` 必填	`string`	`path`	作品 id。
`If-Match` 必填	`string`	`header`	当前 ETag。必填；缺席为 428 PRECONDITION_REQUIRED。
`Idempotency-Key`	`string`	`header`	让请求可以安全重试。24 小时内同一把键配同一请求体，会带着 Idempotency-Replayed: true 重放第一次的响应；同一把键配不同请求体是 409 IDEMPOTENCY_KEY_REUSED；第一次请求还在处理时重试是 409 IDEMPOTENCY_REQUEST_IN_PROGRESS。范围限定为调用方与路径。

请求体

application/json

decisionstring 必填
approve 会发布 pending 认领，decline 将其退回，ban 从任意状态隐藏，unban 恢复被隐藏前的状态。
枚举approvedeclinebanunban
notestring
不得用作判别条件。decline 时必填。

响应

请求示例

cURL

curl -X POST "https://api.nextmoe.dev/v2/moderation/claims/1/decisions" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"decision":"approve"}'