文档 API v2getMyEditCapabilities

getMyEditCapabilities

我在某个族上能编辑什么

由编辑引擎实算的、针对本次调用者的逐字段 can_propose / can_review / would_automerge。能力轴不能挂在 /v2/catalog/schemas/{object} 上:那个面免凭证,而 B34 禁止同一个 URL 按凭证返回不同字段集,所以两者是两个 URL,按 fields[].key 关联。站点开放 owner 通道时请带上 entity_id=,否则 would_automerge 回答的是类型级问题。需要绑定到 catalog 站点的用户访问令牌。令牌须带 catalog:edit scope。

get/v2/me/edit-capabilities/{object}

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

参数

参数	类型	位置	说明
`object` 必填	`string`	`path`	这组能力所描述的族。未知族返回 404 NOT_FOUND。 `workcompanycharacterreleasetagengineseries`
`entity_id`	`integerint64`	`query`	针对某一个实体求值。省略则给类型级答案,而类型级答案表达不了 owner 通道:开放了 owner-review 或 owner-automerge 的站点,在不带它时 would_automerge 一律为 false。

响应

entity_idstring 必填可空
这组能力是针对哪个实体求值的。类型级答案时为 null,而类型级表达不了 owner 通道。
entity_typestring 必填
本族写入时使用的编辑引擎类型。
枚举catalog.workcatalog.labelcatalog.charactercatalog.releasecatalog.tagcatalog.enginecatalog.series
fieldsobject[] 必填
每个可编辑字段一条,顺序与 schema 一致。没有时为空数组,绝不为 null。
- can_proposeboolean 必填
  调用者可以提交涉及该字段的提案时为 true。
- can_reviewboolean 必填
  调用者可以裁决涉及该字段的提案时为 true。开发者自有应用一律为 false,无论该用户持有什么角色。
- keystring 必填
  编辑引擎字段键,与 /v2/catalog/schemas/{object} 的 fields[].key 关联。不得用作判别条件。
- lockedboolean 必填
  本站点的 overlay 对该字段不接受任何人的提案时为 true。
- would_automergeboolean 必填
  该调用者提交的这个字段的提案会立即生效而不进队列时为 true。站点开放 owner 通道时需要带 entity_id。
objectstring 必填
类型判别符,恒为 edit_capabilities。
枚举edit_capabilities
target_objectstring 必填
这组能力所描述的族。
枚举workcompanycharacterreleasetagengineseries

请求示例

cURL

curl "https://api.nextmoe.dev/v2/me/edit-capabilities/work" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"