文档 API v2createMyProposal

createMyProposal

提交提案

在滑动窗口内用满 catalog.proposals_per_day 的贡献者会被拒以 429 QUOTA_EXCEEDED；持 catalog.edit.trusted 者(其提案免审直接合并)按更高的 catalog.proposals_per_day_trusted 计。需要绑定到 catalog 站点的用户访问令牌。令牌须带 catalog:edit scope。

post/v2/me/proposals

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

参数

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

请求体

application/json

entity_idstring 必填
目标 catalog id。
entity_typestring 必填
编辑引擎类型，例如 catalog.work。不得用作判别条件。
notestring
不得用作判别条件。
patchmap<string, object> 必填
字段键到新值。
- «key»object

响应

请求示例

cURL

curl -X POST "https://api.nextmoe.dev/v2/me/proposals" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"entity_id":"1","entity_type":"string","patch":{"key":"string"}}'