# 素人种草 360 API 公开文档 /docs；OpenAPI /docs/openapi.json。 支持浏览器 Cookie 及账号中心签发的 API Key（Authorization: Bearer ltak_…）。中心创建并勾选本应用，首次在产品网页登录后用 issuer/sub 映射本地用户。每次实时校验，不缓存；撤销与过期立即影响后续请求。MCP 未提供。 浏览器 /api/auth/oidc/start 发起登录。先 GET /api/auth/me，再 GET /api/orgs 选择用户授权工作区。 Cookie 写请求须带 Origin（部署 ALLOWED_ORIGINS 内）与 X-Requested-With: suren360；Bearer Key 不需要 CSRF 头，禁止 Cookie 与 Key 混用。有请求体时使用 application/json。成功返回 {data:业务对象}。 业务 ID 必须来自真实查询，工作区之间不得混用。写入不盲目重试；发布、删除、转让和积分操作应确认用户意图。 错误结构 {error:{code,message,details?},requestId}，详见 /docs/errors。平台管理员接口与退役账号接口不纳入工具目录。 ## 确认作品结算 (cooperationConfirm) POST /api/orgs/:orgId/recovered-contents/:id/settlement API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationConfirm 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"amountFen":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["requestId","amountFen"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false} ## 追加作品费用 (cooperationAddAmount) POST /api/orgs/:orgId/settlements/:id/additions API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationAddAmount 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"amountFen":{"type":"integer","minimum":1,"maximum":2147483647},"note":{"default":"","type":"string","maxLength":500}},"required":["requestId","amountFen"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false} ## 撤销作品结算 (cooperationReverseSettlement) POST /api/orgs/:orgId/settlements/:id/reverse API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationReverseSettlement 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["requestId","reason"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false} ## 项目结算列表 (cooperationSettlements) GET /api/orgs/:orgId/settlements API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationSettlements 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"projectId":{"type":"string","minLength":1,"maxLength":32},"contentId":{"type":"string","minLength":1,"maxLength":32},"status":{"type":"string","enum":["pending","partial","paid","reversed"]}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"organizationId":{"type":"string","minLength":1,"maxLength":32},"projectId":{"type":"string","minLength":1,"maxLength":32},"creatorId":{"type":"string","minLength":1,"maxLength":32},"walletId":{"type":"string","minLength":1,"maxLength":32},"contentId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"creatorName":{"type":"string"},"title":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","reversed"]},"confirmedByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"reversedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"reversedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"reversalReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","organizationId","projectId","creatorId","walletId","contentId","projectName","creatorName","title","platform","contentUrl","amountFen","paidFen","pendingFen","status","confirmedByName","createdAt","reversedAt","reversedByName","reversalReason"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"summary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false}},"required":["items","total","page","pageSize","summary"],"additionalProperties":false} ## 作品结算明细 (cooperationSettlement) GET /api/orgs/:orgId/settlements/:id API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationSettlement 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"charges":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"kind":{"type":"string","enum":["settlement","settlement_addition"]},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"note":{"type":"string"},"actorName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","kind","amountFen","note","actorName","createdAt"],"additionalProperties":false}},"settlement":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"organizationId":{"type":"string","minLength":1,"maxLength":32},"projectId":{"type":"string","minLength":1,"maxLength":32},"creatorId":{"type":"string","minLength":1,"maxLength":32},"walletId":{"type":"string","minLength":1,"maxLength":32},"contentId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"creatorName":{"type":"string"},"title":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","reversed"]},"confirmedByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"reversedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"reversedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"reversalReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","organizationId","projectId","creatorId","walletId","contentId","projectName","creatorName","title","platform","contentUrl","amountFen","paidFen","pendingFen","status","confirmedByName","createdAt","reversedAt","reversedByName","reversalReason"],"additionalProperties":false},"payments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"note":{"type":"string"},"createdByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"reversedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"reversedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"reversalReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"allocations":{"type":"array","items":{"type":"object","properties":{"settlementId":{"type":"string","minLength":1,"maxLength":32},"title":{"type":"string"},"projectName":{"type":"string"},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["settlementId","title","projectName","amountFen"],"additionalProperties":false}}},"required":["id","amountFen","note","createdByName","createdAt","reversedAt","reversedByName","reversalReason","allocations"],"additionalProperties":false}}},"required":["charges","settlement","payments"],"additionalProperties":false} ## 素人合作账单 (cooperationStatement) GET /api/orgs/:orgId/creators/:id/statement API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationStatement 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"wallet":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"organizationId":{"type":"string","minLength":1,"maxLength":32},"organizationName":{"type":"string"},"creatorId":{"type":"string","minLength":1,"maxLength":32},"creatorName":{"type":"string"},"summary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false}},"required":["id","organizationId","organizationName","creatorId","creatorName","summary"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"kind":{"type":"string","enum":["settlement","settlement_reversal","settlement_addition","payment","payment_reversal"]},"deltaFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"actorName":{"type":"string"},"note":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"settlement":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"organizationId":{"type":"string","minLength":1,"maxLength":32},"projectId":{"type":"string","minLength":1,"maxLength":32},"creatorId":{"type":"string","minLength":1,"maxLength":32},"walletId":{"type":"string","minLength":1,"maxLength":32},"contentId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"creatorName":{"type":"string"},"title":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","reversed"]},"confirmedByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"reversedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"reversedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"reversalReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","organizationId","projectId","creatorId","walletId","contentId","projectName","creatorName","title","platform","contentUrl","amountFen","paidFen","pendingFen","status","confirmedByName","createdAt","reversedAt","reversedByName","reversalReason"],"additionalProperties":false},{"type":"null"}]},"payment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"note":{"type":"string"},"createdByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"reversedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"reversedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"reversalReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"allocations":{"type":"array","items":{"type":"object","properties":{"settlementId":{"type":"string","minLength":1,"maxLength":32},"title":{"type":"string"},"projectName":{"type":"string"},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["settlementId","title","projectName","amountFen"],"additionalProperties":false}}},"required":["id","amountFen","note","createdByName","createdAt","reversedAt","reversedByName","reversalReason","allocations"],"additionalProperties":false},{"type":"null"}]}},"required":["id","kind","deltaFen","balanceFen","actorName","note","createdAt","settlement","payment"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["wallet","items","total","page","pageSize"],"additionalProperties":false} ## 登记线下付款 (cooperationPay) POST /api/orgs/:orgId/creators/:id/payments API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationPay 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"amountFen":{"type":"integer","minimum":1,"maximum":2147483647},"note":{"default":"","type":"string","maxLength":500}},"required":["requestId","amountFen"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false} ## 撤销付款登记 (cooperationReversePayment) POST /api/orgs/:orgId/cooperation-payments/:id/reverse API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/cooperationReversePayment 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["requestId","reason"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false} ## 我的合作钱包 (myCooperationWallets) GET /api/my/cooperation-wallets API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/myCooperationWallets 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"organizationId":{"type":"string","minLength":1,"maxLength":32},"organizationName":{"type":"string"},"creatorId":{"type":"string","minLength":1,"maxLength":32},"creatorName":{"type":"string"},"summary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false}},"required":["id","organizationId","organizationName","creatorId","creatorName","summary"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 我的合作账单 (myCooperationStatement) GET /api/my/cooperation-wallets/:id/statement API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/myCooperationStatement 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"wallet":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"organizationId":{"type":"string","minLength":1,"maxLength":32},"organizationName":{"type":"string"},"creatorId":{"type":"string","minLength":1,"maxLength":32},"creatorName":{"type":"string"},"summary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false}},"required":["id","organizationId","organizationName","creatorId","creatorName","summary"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"kind":{"type":"string","enum":["settlement","settlement_reversal","settlement_addition","payment","payment_reversal"]},"deltaFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"actorName":{"type":"string"},"note":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"settlement":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"organizationId":{"type":"string","minLength":1,"maxLength":32},"projectId":{"type":"string","minLength":1,"maxLength":32},"creatorId":{"type":"string","minLength":1,"maxLength":32},"walletId":{"type":"string","minLength":1,"maxLength":32},"contentId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"creatorName":{"type":"string"},"title":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","reversed"]},"confirmedByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"reversedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"reversedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"reversalReason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","organizationId","projectId","creatorId","walletId","contentId","projectName","creatorName","title","platform","contentUrl","amountFen","paidFen","pendingFen","status","confirmedByName","createdAt","reversedAt","reversedByName","reversalReason"],"additionalProperties":false},{"type":"null"}]},"payment":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"note":{"type":"string"},"createdByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"reversedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"reversedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"reversalReason":{"anyOf":[{"type":"string"},{"type":"null"}]},"allocations":{"type":"array","items":{"type":"object","properties":{"settlementId":{"type":"string","minLength":1,"maxLength":32},"title":{"type":"string"},"projectName":{"type":"string"},"amountFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["settlementId","title","projectName","amountFen"],"additionalProperties":false}}},"required":["id","amountFen","note","createdByName","createdAt","reversedAt","reversedByName","reversalReason","allocations"],"additionalProperties":false},{"type":"null"}]}},"required":["id","kind","deltaFen","balanceFen","actorName","note","createdAt","settlement","payment"],"additionalProperties":false}},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["wallet","items","total","page","pageSize"],"additionalProperties":false} ## materialFetch (materialFetch) POST /api/orgs/:orgId/materials/fetch API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/materialFetch 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"videoUrl":{"type":"string","maxLength":2000,"format":"uri"}},"required":["videoUrl"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"material":{"type":"object","properties":{"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"materialType":{"anyOf":[{"type":"string"},{"type":"null"}]},"videoId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uniqueId":{"anyOf":[{"type":"string"},{"type":"null"}]},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}]},"playCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"shareCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"forwardCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"playAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"downloadAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"imageList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"width":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"additionalProperties":false}},{"type":"null"}]},"videoDesc":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"releaseAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":253402300799},{"type":"null"}]},"shareUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"additionalProperties":false}},"required":["material"],"additionalProperties":false} ## 发布计划列表 (publishingList) GET /api/orgs/:orgId/publishing-plans API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/publishingList 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"projectId":{"type":"string","maxLength":32},"status":{"type":"string","enum":["draft","published","stopped"]}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"projectId":{"type":"string"},"project":{"type":"string"},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notes":{"type":"string"},"status":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"canEdit":{"type":"boolean"},"groups":{"type":"array","items":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}}},"required":["id","projectId","project","deadline","notes","status","publishedAt","createdAt","canEdit","groups"],"additionalProperties":false}},"total":{"type":"number"},"page":{"type":"number"},"pageSize":{"type":"number"}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 创建发布计划 (publishingCreate) POST /api/orgs/:orgId/publishing-plans API Key：支持 权限：当前有效工作区成员；关联项目必须属于当前工作区 文档：/docs/publishingCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projectId":{"type":"string","minLength":1,"maxLength":32},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notes":{"default":"","type":"string","maxLength":2000},"videoCount":{"type":"integer","minimum":0,"maximum":100},"imageTextCount":{"type":"integer","minimum":0,"maximum":100}},"required":["projectId","deadline","videoCount","imageTextCount"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string"},"projectId":{"type":"string"},"project":{"type":"string"},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notes":{"type":"string"},"status":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"canEdit":{"type":"boolean"},"groups":{"type":"array","items":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}}},"required":["id","projectId","project","deadline","notes","status","publishedAt","createdAt","canEdit","groups"],"additionalProperties":false}},"required":["plan"],"additionalProperties":false} ## 发布计划详情 (publishingGet) GET /api/orgs/:orgId/publishing-plans/:id API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/publishingGet 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string"},"projectId":{"type":"string"},"project":{"type":"string"},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notes":{"type":"string"},"status":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"canEdit":{"type":"boolean"},"groups":{"type":"array","items":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}}},"required":["id","projectId","project","deadline","notes","status","publishedAt","createdAt","canEdit","groups"],"additionalProperties":false}},"required":["plan"],"additionalProperties":false} ## 删除发布计划 (publishingDelete) DELETE /api/orgs/:orgId/publishing-plans/:id API Key：支持 权限：所有者、管理员或计划创建人；正文和素材仅草稿可改，状态限制以服务端为准 文档：/docs/publishingDelete 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 修改发布计划 (publishingUpdate) PATCH /api/orgs/:orgId/publishing-plans/:id API Key：支持 权限：所有者、管理员或计划创建人；正文和素材仅草稿可改，状态限制以服务端为准 文档：/docs/publishingUpdate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projectId":{"type":"string","minLength":1,"maxLength":32},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notes":{"default":"","type":"string","maxLength":2000},"videoCount":{"type":"integer","minimum":0,"maximum":100},"imageTextCount":{"type":"integer","minimum":0,"maximum":100}},"required":["projectId","deadline","videoCount","imageTextCount"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string"},"projectId":{"type":"string"},"project":{"type":"string"},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notes":{"type":"string"},"status":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"canEdit":{"type":"boolean"},"groups":{"type":"array","items":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}}},"required":["id","projectId","project","deadline","notes","status","publishedAt","createdAt","canEdit","groups"],"additionalProperties":false}},"required":["plan"],"additionalProperties":false} ## 内容组详情 (publishingGroupGet) GET /api/orgs/:orgId/publishing-groups/:id API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/publishingGroupGet 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"group":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}},"required":["group"],"additionalProperties":false} ## 保存图组图片顺序 (publishingImagesOrder) PATCH /api/orgs/:orgId/publishing-groups/:id/images-order API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/publishingImagesOrder 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fileIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":32}}},"required":["fileIds"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"group":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}},"required":["group"],"additionalProperties":false} ## 保存计划正文 (publishingDocument) PATCH /api/orgs/:orgId/publishing-groups/:id/document API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/publishingDocument 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","maxLength":1048576}},"required":["text"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"group":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}},"required":["group"],"additionalProperties":false} ## 获取文件上传签名 (publishingUpload) POST /api/orgs/:orgId/publishing-groups/:id/uploads API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/publishingUpload 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"mime":{"type":"string","maxLength":100},"size":{"type":"integer","exclusiveMinimum":0,"maximum":524288000},"requestId":{"type":"string","minLength":1,"maxLength":64}},"required":["name","mime","size","requestId"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"file":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false},"uploadUrl":{"type":"string"},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["file","uploadUrl","fields"],"additionalProperties":false} ## 确认文件上传 (publishingComplete) POST /api/orgs/:orgId/publishing-files/:id/complete API Key：支持 权限：所有者、管理员或计划创建人；正文和素材仅草稿可改，状态限制以服务端为准 文档：/docs/publishingComplete 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"group":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}},"required":["group"],"additionalProperties":false} ## 删除计划文件 (publishingRemove) DELETE /api/orgs/:orgId/publishing-files/:id API Key：支持 权限：所有者、管理员或计划创建人；正文和素材仅草稿可改，状态限制以服务端为准 文档：/docs/publishingRemove 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 生成分享链接 (publishingPublish) POST /api/orgs/:orgId/publishing-plans/:id/publish API Key：支持 权限：所有者、管理员或计划创建人；正文和素材仅草稿可改，状态限制以服务端为准 文档：/docs/publishingPublish 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"object","properties":{"id":{"type":"string"},"projectId":{"type":"string"},"project":{"type":"string"},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notes":{"type":"string"},"status":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"canEdit":{"type":"boolean"},"groups":{"type":"array","items":{"type":"object","properties":{"submissionCount":{"type":"number"},"id":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"position":{"type":"number"},"documentName":{"type":"string"},"documentText":{"type":"string"},"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"claimantName":{"anyOf":[{"type":"string"},{"type":"null"}]},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["submissionCount","id","kind","position","documentName","documentText","shareToken","claimedAt","claimantName","files","submissions"],"additionalProperties":false}}},"required":["id","projectId","project","deadline","notes","status","publishedAt","createdAt","canEdit","groups"],"additionalProperties":false}},"required":["plan"],"additionalProperties":false} ## 停止发布计划 (publishingStop) POST /api/orgs/:orgId/publishing-plans/:id/stop API Key：支持 权限：所有者、管理员或计划创建人；正文和素材仅草稿可改，状态限制以服务端为准 文档：/docs/publishingStop 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 获取计划文件地址 (publishingMedia) GET /api/orgs/:orgId/publishing-files/:id/url API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/publishingMedia 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false} ## 分享任务详情 (shareGet) GET /api/publishing-shares/:token API Key：支持 权限：匿名仅返回任务摘要；领取者才可查看正文和素材 文档：/docs/shareGet 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"organization":{"type":"object","properties":{"name":{"type":"string"},"companyName":{"type":"string"},"contactEmail":{"type":"string"},"contactPhone":{"type":"string"},"reportEmail":{"type":"string"},"reportWechat":{"type":"string"}},"required":["name","companyName","contactEmail","contactPhone","reportEmail","reportWechat"],"additionalProperties":false},"project":{"type":"string"},"kind":{"type":"string","enum":["video","image"]},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"status":{"type":"string"},"availability":{"type":"string","enum":["available","mine","claimed","expired","stopped"]},"documentText":{"type":"string"},"notes":{"type":"string"},"files":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"mime":{"type":"string"},"size":{"type":"number"},"kind":{"type":"string","enum":["video","image","document"]},"status":{"type":"string"}},"required":["id","name","mime","size","kind","status"],"additionalProperties":false}},"submissions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string"},"platform":{"type":"string"},"accountName":{"type":"string"},"accountHomepage":{"type":"string"},"resolution":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","url","platform","accountName","accountHomepage","resolution","createdAt"],"additionalProperties":false}}},"required":["organization","project","kind","deadline","status","availability"],"additionalProperties":false} ## 领取分享任务 (shareClaim) POST /api/publishing-shares/:token/claim API Key：支持 权限：统一登录用户；任务有效且尚可领取 文档：/docs/shareClaim 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## sharePreview (sharePreview) POST /api/publishing-shares/:token/preview API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/sharePreview 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"urls":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}},"previewToken":{"type":"string","minLength":48,"maxLength":48},"account":{"type":"object","properties":{"platform":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号"]},"nickname":{"type":"string","minLength":1,"maxLength":120},"homepage":{"type":"string","maxLength":2000,"format":"uri"},"stableId":{"type":"string","maxLength":191}},"required":["platform","nickname","homepage"]}},"required":["urls"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"previewToken":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"},"material":{"anyOf":[{"type":"object","properties":{"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"materialType":{"anyOf":[{"type":"string"},{"type":"null"}]},"videoId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uniqueId":{"anyOf":[{"type":"string"},{"type":"null"}]},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}]},"playCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"shareCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"forwardCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"playAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"downloadAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"imageList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"width":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"additionalProperties":false}},{"type":"null"}]},"videoDesc":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"releaseAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":253402300799},{"type":"null"}]},"shareUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["url","material"],"additionalProperties":false}}},"required":["previewToken","items"],"additionalProperties":false} ## 回填作品链接 (shareSubmit) POST /api/publishing-shares/:token/submissions API Key：支持 权限：当前任务领取者；受任务状态、截止时间和档案状态约束 文档：/docs/shareSubmit 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"urls":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}},"previewToken":{"type":"string","minLength":48,"maxLength":48},"account":{"type":"object","properties":{"platform":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号"]},"nickname":{"type":"string","minLength":1,"maxLength":120},"homepage":{"type":"string","maxLength":2000,"format":"uri"},"stableId":{"type":"string","maxLength":191}},"required":["platform","nickname","homepage"]}},"required":["urls"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"submitted":{"type":"number"},"duplicates":{"type":"number"}},"required":["submitted","duplicates"],"additionalProperties":false} ## 获取任务文件地址 (shareMedia) GET /api/publishing-shares/:token/files/:id API Key：支持 权限：当前任务领取者；受任务状态、截止时间和档案状态约束 文档：/docs/shareMedia 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false} ## 我的发布任务 (myPublishingTasks) GET /api/my/publishing-tasks API Key：支持 权限：当前有效登录用户 文档：/docs/myPublishingTasks 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string"},"project":{"type":"string"},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"status":{"type":"string"},"submitted":{"type":"number"}},"required":["token","project","deadline","status","submitted"],"additionalProperties":false}},"total":{"type":"number"},"page":{"type":"number"},"pageSize":{"type":"number"}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## socialAccountCreate (socialAccountCreate) POST /api/orgs/:orgId/social-accounts API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/socialAccountCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creatorId":{"type":"string","minLength":1},"platform":{"type":"string","minLength":1,"maxLength":40},"nickname":{"type":"string","minLength":1,"maxLength":120},"stableId":{"default":"","type":"string","maxLength":191},"homepage":{"default":"","type":"string","maxLength":2000}},"required":["creatorId","platform","nickname"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 平台账号列表 (socialAccounts) GET /api/orgs/:orgId/social-accounts API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/socialAccounts 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"creatorId":{"type":"string"},"platform":{"type":"string","maxLength":40}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"conflicts":{"type":"array","items":{"type":"object","properties":{"creatorId":{"type":"string"},"creatorName":{"type":"string"},"url":{"type":"string"}},"required":["creatorId","creatorName","url"],"additionalProperties":false}},"id":{"type":"string"},"creatorId":{"type":"string"},"creatorName":{"type":"string"},"platform":{"type":"string"},"stableId":{"anyOf":[{"type":"string"},{"type":"null"}]},"nickname":{"type":"string"},"homepage":{"type":"string"},"reviewStatus":{"type":"string"}},"required":["conflicts","id","creatorId","creatorName","platform","stableId","nickname","homepage","reviewStatus"],"additionalProperties":false}},"total":{"type":"number"},"page":{"type":"number"},"pageSize":{"type":"number"}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 审核素人档案 (creatorReview) PATCH /api/orgs/:orgId/creators/:id/review API Key：支持 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/creatorReview 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","enum":["approved","pending","suspended"]}},"required":["status"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 审核平台账号 (socialAccountReview) PATCH /api/orgs/:orgId/social-accounts/:id/review API Key：支持 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/socialAccountReview 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","enum":["approved","pending","suspended"]},"creatorId":{"type":"string","maxLength":32}},"required":["status"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 项目负责人选项 (projectOwners) GET /api/orgs/:orgId/project-owners API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/projectOwners 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"nickname":{"type":"string"}},"required":["userId","nickname"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false} ## recoveredContentDelete (recoveredContentDelete) PATCH /api/orgs/:orgId/recovered-contents/:id/delete API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/recoveredContentDelete 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updated":{"type":"boolean","const":true}},"required":["updated"],"additionalProperties":false} ## 编辑回收内容 (recoveredContentUpdate) PATCH /api/orgs/:orgId/recovered-contents/:id API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/recoveredContentUpdate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"socialAccountId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]}},"required":["socialAccountId"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updated":{"type":"boolean","const":true}},"required":["updated"],"additionalProperties":false} ## 更正回收平台 (recoveredContentPlatformUpdate) PATCH /api/orgs/:orgId/recovered-contents/:id/platform API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/recoveredContentPlatformUpdate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"platform":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台","未知"]}},"required":["platform"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updated":{"type":"boolean","const":true}},"required":["updated"],"additionalProperties":false} ## recoveredContentCollect (recoveredContentCollect) POST /api/orgs/:orgId/recovered-contents/collect API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/recoveredContentCollect 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"videoUrl":{"type":"string","maxLength":2000,"format":"uri"},"projectId":{"type":"string","minLength":1,"maxLength":32}},"required":["videoUrl","projectId"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"content":{"type":"object","properties":{"settlement":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"amountFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confirmedByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","amountFen","paidFen","confirmedByName","createdAt"],"additionalProperties":false},{"type":"null"}]},"canDelete":{"type":"boolean"},"canChangeAssociation":{"type":"boolean"},"deletedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"socialAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"accountNickname":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"materialData":{"anyOf":[{"type":"object","properties":{"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"materialType":{"anyOf":[{"type":"string"},{"type":"null"}]},"videoId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uniqueId":{"anyOf":[{"type":"string"},{"type":"null"}]},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}]},"playCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"shareCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"forwardCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"playAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"downloadAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"imageList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"width":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"additionalProperties":false}},{"type":"null"}]},"videoDesc":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"releaseAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":253402300799},{"type":"null"}]},"shareUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"fetchedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"id":{"type":"string"},"projectId":{"type":"string"},"projectName":{"type":"string"},"title":{"type":"string"},"creatorName":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"body":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"collectedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["deletedAt","id","projectId","projectName","title","creatorName","platform","contentUrl","body","publishedAt","collectedAt"],"additionalProperties":false},"updated":{"type":"boolean"}},"required":["content","updated"],"additionalProperties":false} ## 批量回收作品链接 (recoveredContentBatch) POST /api/orgs/:orgId/recovered-contents/batch API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/recoveredContentBatch 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projectId":{"type":"string","minLength":1,"maxLength":32},"urls":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","maxLength":2000,"format":"uri"}}},"required":["projectId","urls"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"added":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"skipped":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["added","skipped"],"additionalProperties":false} ## 项目名称选项 (projectOptions) GET /api/orgs/:orgId/project-options API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/projectOptions 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false} ## 内容回收列表 (recoveredContents) GET /api/orgs/:orgId/recovered-contents API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/recoveredContents 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"status":{"type":"string","enum":["active","deleted"]},"publishedFrom":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"publishedTo":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"platform":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台","未知"]},"projectId":{"type":"string","minLength":1,"maxLength":32}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"settlement":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"amountFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"confirmedByName":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","amountFen","paidFen","confirmedByName","createdAt"],"additionalProperties":false},{"type":"null"}]},"canDelete":{"type":"boolean"},"canChangeAssociation":{"type":"boolean"},"deletedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"socialAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"accountNickname":{"anyOf":[{"type":"string"},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"materialData":{"anyOf":[{"type":"object","properties":{"platform":{"anyOf":[{"type":"string"},{"type":"null"}]},"materialType":{"anyOf":[{"type":"string"},{"type":"null"}]},"videoId":{"anyOf":[{"type":"string"},{"type":"null"}]},"uniqueId":{"anyOf":[{"type":"string"},{"type":"null"}]},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}]},"playCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"shareCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"downloadCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"forwardCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"coverUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"playAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"downloadAddr":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"imageList":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"width":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"height":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"additionalProperties":false}},{"type":"null"}]},"videoDesc":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"releaseAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":253402300799},{"type":"null"}]},"shareUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"fetchedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"id":{"type":"string"},"projectId":{"type":"string"},"projectName":{"type":"string"},"title":{"type":"string"},"creatorName":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"body":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"collectedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["deletedAt","id","projectId","projectName","title","creatorName","platform","contentUrl","body","publishedAt","collectedAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 种草项目列表 (projects) GET /api/orgs/:orgId/projects API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/projects 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"status":{"type":"string","enum":["planning","active","completed","archived"]},"platform":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"status":{"type":"string","enum":["planning","active","completed","archived"]},"notes":{"type":"string"},"canEdit":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","organizationId","name","responsibleUserId","responsibleName","startsOn","endsOn","budgetFen","platform","status","notes","canEdit","createdAt","updatedAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 种草项目详情 (projectGet) GET /api/orgs/:orgId/projects/:id API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/projectGet 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"status":{"type":"string","enum":["planning","active","completed","archived"]},"notes":{"type":"string"},"canEdit":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","organizationId","name","responsibleUserId","responsibleName","startsOn","endsOn","budgetFen","platform","status","notes","canEdit","createdAt","updatedAt"],"additionalProperties":false}},"required":["project"],"additionalProperties":false} ## 创建种草项目 (projectCreate) POST /api/orgs/:orgId/projects API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/projectCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"responsibleUserId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]},"startsOn":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"endsOn":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"budgetFen":{"type":"integer","minimum":0,"maximum":2147483647},"platform":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]},"status":{"default":"planning","type":"string","enum":["planning","active","completed","archived"]},"notes":{"default":"","type":"string","maxLength":5000}},"required":["name","responsibleUserId","startsOn","endsOn","budgetFen","platform"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"status":{"type":"string","enum":["planning","active","completed","archived"]},"notes":{"type":"string"},"canEdit":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","organizationId","name","responsibleUserId","responsibleName","startsOn","endsOn","budgetFen","platform","status","notes","canEdit","createdAt","updatedAt"],"additionalProperties":false}},"required":["project"],"additionalProperties":false} ## 修改种草项目 (projectUpdate) PATCH /api/orgs/:orgId/projects/:id API Key：支持 权限：所有者、管理员、项目创建人或当前负责人 文档：/docs/projectUpdate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"responsibleUserId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]},"startsOn":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"endsOn":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"budgetFen":{"type":"integer","minimum":0,"maximum":2147483647},"platform":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]},"status":{"default":"planning","type":"string","enum":["planning","active","completed","archived"]},"notes":{"default":"","type":"string","maxLength":5000}},"required":["name","responsibleUserId","startsOn","endsOn","budgetFen","platform"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"status":{"type":"string","enum":["planning","active","completed","archived"]},"notes":{"type":"string"},"canEdit":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","organizationId","name","responsibleUserId","responsibleName","startsOn","endsOn","budgetFen","platform","status","notes","canEdit","createdAt","updatedAt"],"additionalProperties":false}},"required":["project"],"additionalProperties":false} ## 共享积分状态 (sharedCredits) GET /api/orgs/:orgId/shared-credits API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；授权流程必须在当前用户浏览器会话中完成 文档：/docs/sharedCredits 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"authorized":{"type":"boolean"},"available":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"frozen":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"dailyLimit":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"dailyUsed":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"rechargeUrl":{"type":"string","format":"uri"}},"required":["authorized","available","frozen","dailyLimit","dailyUsed","rechargeUrl"],"additionalProperties":false} ## 发起共享积分授权 (sharedCreditsAuthorize) POST /api/orgs/:orgId/shared-credits/authorize API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；授权流程必须在当前用户浏览器会话中完成 文档：/docs/sharedCreditsAuthorize 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"confirmationUrl":{"type":"string","format":"uri"},"mode":{"type":"string","enum":["redirect","manual"]}},"required":["confirmationUrl","mode"],"additionalProperties":false} ## 完成共享积分授权 (sharedCreditsComplete) POST /api/orgs/:orgId/shared-credits/complete API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；授权流程必须在当前用户浏览器会话中完成 文档：/docs/sharedCreditsComplete 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"},"result":{"type":"string","enum":["authorized","cancelled"]}},"required":["state","result"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"authorized":{"type":"boolean"},"available":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"frozen":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"dailyLimit":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"dailyUsed":{"anyOf":[{"type":"string","pattern":"^\\d+(\\.\\d)?$"},{"type":"null"}]},"rechargeUrl":{"type":"string","format":"uri"}},"required":["authorized","available","frozen","dailyLimit","dailyUsed","rechargeUrl"],"additionalProperties":false} ## 积分划转记录 (creditTransfers) GET /api/orgs/:orgId/credit-transfers API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/creditTransfers 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"points":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"amountYuan":{"type":"string"},"state":{"type":"string","enum":["creating","awaiting_confirmation","credited","expired"]},"confirmationUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"canContinue":{"type":"boolean"},"createdAt":{"type":"string"},"creditedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"acknowledged":{"type":"boolean"},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","points","amountYuan","state","confirmationUrl","canContinue","createdAt","creditedAt","acknowledged","errorCode"],"additionalProperties":false}},"rechargeUrl":{"type":"string","format":"uri"}},"required":["items","rechargeUrl"],"additionalProperties":false} ## 创建积分划转 (creditTransferCreate) POST /api/orgs/:orgId/credit-transfers API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/creditTransferCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"amountYuan":{"type":"string"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["amountYuan","requestId"],"additionalProperties":false},{"type":"object","properties":{"points":{"type":"integer","minimum":1,"maximum":1000000},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["points","requestId"],"additionalProperties":false}]} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transfer":{"type":"object","properties":{"id":{"type":"string"},"points":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"amountYuan":{"type":"string"},"state":{"type":"string","enum":["creating","awaiting_confirmation","credited","expired"]},"confirmationUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"canContinue":{"type":"boolean"},"createdAt":{"type":"string"},"creditedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"acknowledged":{"type":"boolean"},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","points","amountYuan","state","confirmationUrl","canContinue","createdAt","creditedAt","acknowledged","errorCode"],"additionalProperties":false}},"required":["transfer"],"additionalProperties":false} ## 同步积分划转 (creditTransfersSync) POST /api/orgs/:orgId/credit-transfers/sync API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/creditTransfersSync 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 重试积分划转 (creditTransferRetry) POST /api/orgs/:orgId/credit-transfers/:id/retry API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/creditTransferRetry 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transfer":{"type":"object","properties":{"id":{"type":"string"},"points":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"amountYuan":{"type":"string"},"state":{"type":"string","enum":["creating","awaiting_confirmation","credited","expired"]},"confirmationUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"canContinue":{"type":"boolean"},"createdAt":{"type":"string"},"creditedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"acknowledged":{"type":"boolean"},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","points","amountYuan","state","confirmationUrl","canContinue","createdAt","creditedAt","acknowledged","errorCode"],"additionalProperties":false}},"required":["transfer"],"additionalProperties":false} ## 成员分组列表 (groups) GET /api/orgs/:orgId/groups API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/groups 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"mine":{"default":"false","type":"string","enum":["true","false"]}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"isDefault":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"leaderUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderStatus":{"anyOf":[{"type":"string","enum":["active","suspended"]},{"type":"null"}]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"myRole":{"anyOf":[{"type":"string","enum":["leader","member"]},{"type":"null"}]}},"required":["id","name","description","leaderUserId","leaderName","leaderStatus","memberCount","creatorCount","myRole"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 创建成员分组 (groupCreate) POST /api/orgs/:orgId/groups API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/groupCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"default":"","type":"string","maxLength":500}},"required":["name"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"group":{"type":"object","properties":{"isDefault":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"leaderUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderStatus":{"anyOf":[{"type":"string","enum":["active","suspended"]},{"type":"null"}]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"myRole":{"anyOf":[{"type":"string","enum":["leader","member"]},{"type":"null"}]}},"required":["id","name","description","leaderUserId","leaderName","leaderStatus","memberCount","creatorCount","myRole"],"additionalProperties":false}},"required":["group"],"additionalProperties":false} ## 成员分组详情 (groupGet) GET /api/orgs/:orgId/groups/:id API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/groupGet 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"group":{"type":"object","properties":{"isDefault":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"leaderUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderStatus":{"anyOf":[{"type":"string","enum":["active","suspended"]},{"type":"null"}]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"myRole":{"anyOf":[{"type":"string","enum":["leader","member"]},{"type":"null"}]}},"required":["id","name","description","leaderUserId","leaderName","leaderStatus","memberCount","creatorCount","myRole"],"additionalProperties":false}},"required":["group"],"additionalProperties":false} ## 修改成员分组 (groupUpdate) PATCH /api/orgs/:orgId/groups/:id API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/groupUpdate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"default":"","type":"string","maxLength":500}},"required":["name"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"group":{"type":"object","properties":{"isDefault":{"type":"boolean"},"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"leaderUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderName":{"anyOf":[{"type":"string"},{"type":"null"}]},"leaderStatus":{"anyOf":[{"type":"string","enum":["active","suspended"]},{"type":"null"}]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"creatorCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"myRole":{"anyOf":[{"type":"string","enum":["leader","member"]},{"type":"null"}]}},"required":["id","name","description","leaderUserId","leaderName","leaderStatus","memberCount","creatorCount","myRole"],"additionalProperties":false}},"required":["group"],"additionalProperties":false} ## 解散成员分组 (groupDissolve) DELETE /api/orgs/:orgId/groups/:id API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/groupDissolve 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"targetGroupId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]},"responsibleUserId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]}},"required":["targetGroupId","responsibleUserId"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 小组成员列表 (groupMembers) GET /api/orgs/:orgId/groups/:id/members API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/groupMembers 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"userId":{"type":"string"},"nickname":{"type":"string"},"accountId":{"type":"string"},"status":{"type":"string","enum":["active","suspended"]},"role":{"type":"string","enum":["leader","member"]},"responsibleCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["userId","nickname","accountId","status","role","responsibleCount"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 添加小组成员 (groupMemberAdd) POST /api/orgs/:orgId/groups/:id/members API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/groupMemberAdd 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"userId":{"type":"string","minLength":1,"maxLength":32}},"required":["userId"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 移除小组成员 (groupMemberRemove) DELETE /api/orgs/:orgId/groups/:id/members/:userId API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/groupMemberRemove 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"clearResponsibilities":{"type":"boolean","const":true}},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 设置小组组长 (groupLeader) PATCH /api/orgs/:orgId/groups/:id/leader API Key：支持 权限：工作区所有者或管理员；受责任交接规则约束 文档：/docs/groupLeader 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"userId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]}},"required":["userId"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 分配素人责任 (creatorsAssign) POST /api/orgs/:orgId/creator-assignments API Key：支持 权限：所有者、管理员或组长；组长仅可调整本组分工 文档：/docs/creatorsAssign 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"groupId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]},"responsibleUserId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]},"creatorIds":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":32}}},"required":["groupId","responsibleUserId","creatorIds"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 存活检查 (live) GET /api/health/live API Key：不支持，仅浏览器会话 权限：无需登录；仅返回公开状态或当前会话摘要 文档：/docs/live 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","const":"ok"}},"required":["status"],"additionalProperties":false} ## 就绪检查 (ready) GET /api/health/ready API Key：不支持，仅浏览器会话 权限：无需登录；仅返回公开状态或当前会话摘要 文档：/docs/ready 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","const":"ok"},"database":{"type":"boolean","const":true},"redis":{"type":"boolean","const":true}},"required":["status","database","redis"],"additionalProperties":false} ## 当前账号会话 (sessions) GET /api/auth/sessions API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/sessions 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"lastSeenAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"current":{"type":"boolean"}},"required":["id","createdAt","lastSeenAt","expiresAt","current"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false} ## 撤销指定会话 (sessionRevoke) DELETE /api/auth/sessions/:id API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/sessionRevoke 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 撤销其他会话 (sessionsRevokeOthers) POST /api/auth/sessions/revoke-others API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/sessionsRevokeOthers 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 我的工作区 (organizations) GET /api/orgs API Key：支持 权限：当前有效登录用户 文档：/docs/organizations 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"companyName":{"type":"string"},"contactEmail":{"type":"string"},"contactPhone":{"type":"string"},"reportEmail":{"type":"string"},"reportWechat":{"type":"string"},"status":{"type":"string","enum":["active","suspended"]},"role":{"type":"string","enum":["owner","admin","member"]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","name","description","status","role","memberCount","createdAt"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false} ## 创建工作区 (organizationCreate) POST /api/orgs API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/organizationCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"default":"","type":"string","maxLength":500},"companyName":{"type":"string","maxLength":200},"contactEmail":{"anyOf":[{"type":"string","const":""},{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}]},"contactPhone":{"type":"string","maxLength":254},"reportEmail":{"anyOf":[{"type":"string","const":""},{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}]},"reportWechat":{"type":"string","maxLength":254}},"required":["name"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"companyName":{"type":"string"},"contactEmail":{"type":"string"},"contactPhone":{"type":"string"},"reportEmail":{"type":"string"},"reportWechat":{"type":"string"},"status":{"type":"string","enum":["active","suspended"]},"role":{"type":"string","enum":["owner","admin","member"]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","name","description","status","role","memberCount","createdAt"],"additionalProperties":false}},"required":["organization"],"additionalProperties":false} ## 工作区详情 (organization) GET /api/orgs/:orgId API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/organization 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"companyName":{"type":"string"},"contactEmail":{"type":"string"},"contactPhone":{"type":"string"},"reportEmail":{"type":"string"},"reportWechat":{"type":"string"},"status":{"type":"string","enum":["active","suspended"]},"role":{"type":"string","enum":["owner","admin","member"]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","name","description","status","role","memberCount","createdAt"],"additionalProperties":false}},"required":["organization"],"additionalProperties":false} ## 修改工作区 (organizationUpdate) PATCH /api/orgs/:orgId API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/organizationUpdate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"description":{"default":"","type":"string","maxLength":500},"companyName":{"type":"string","maxLength":200},"contactEmail":{"anyOf":[{"type":"string","const":""},{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}]},"contactPhone":{"type":"string","maxLength":254},"reportEmail":{"anyOf":[{"type":"string","const":""},{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}]},"reportWechat":{"type":"string","maxLength":254}},"required":["name"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"companyName":{"type":"string"},"contactEmail":{"type":"string"},"contactPhone":{"type":"string"},"reportEmail":{"type":"string"},"reportWechat":{"type":"string"},"status":{"type":"string","enum":["active","suspended"]},"role":{"type":"string","enum":["owner","admin","member"]},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","name","description","status","role","memberCount","createdAt"],"additionalProperties":false}},"required":["organization"],"additionalProperties":false} ## 工作台概览 (workspaceDashboard) GET /api/orgs/:orgId/dashboard API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/workspaceDashboard 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"activeProjects":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"runningPlans":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"recoveredContents":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"activeCreators":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"draftPlans":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pendingCreators":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"awaitingSubmission":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"projects":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"status":{"type":"string"},"endsOn":{"type":"string"}},"required":["id","name","platform","status","endsOn"],"additionalProperties":false}},"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"projectName":{"type":"string"},"status":{"type":"string"},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"groups":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"submitted":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","projectName","status","deadline","groups","submitted"],"additionalProperties":false}}},"required":["activeProjects","runningPlans","recoveredContents","activeCreators","draftPlans","pendingCreators","awaitingSubmission","projects","plans"],"additionalProperties":false} ## 工作区统计 (overview) GET /api/orgs/:orgId/overview API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/overview 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creators":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"activeCreators":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"members":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdThisMonth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["creators","activeCreators","members","createdThisMonth"],"additionalProperties":false} ## 工作区成员 (members) GET /api/orgs/:orgId/members API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/members 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"groupId":{"type":"string","maxLength":32},"userId":{"type":"string","minLength":1,"maxLength":32}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"nickname":{"type":"string"},"accountId":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"responsibleCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"role":{"type":"string","enum":["leader","member"]}},"required":["id","name","responsibleCount","role"],"additionalProperties":false}},"responsibleCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"joinedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"status":{"type":"string","enum":["active","suspended"]}},"required":["id","userId","nickname","accountId","role","groups","responsibleCount","joinedAt","status"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 设置成员角色 (memberRole) PATCH /api/orgs/:orgId/members/:userId API Key：不支持，仅浏览器会话 权限：工作区所有者；目标成员必须有效，受交接规则约束 文档：/docs/memberRole 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"role":{"type":"string","enum":["admin","member"]}},"required":["role"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"member":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"nickname":{"type":"string"},"accountId":{"type":"string"},"role":{"type":"string","enum":["owner","admin","member"]},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"responsibleCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"role":{"type":"string","enum":["leader","member"]}},"required":["id","name","responsibleCount","role"],"additionalProperties":false}},"responsibleCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"joinedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"status":{"type":"string","enum":["active","suspended"]}},"required":["id","userId","nickname","accountId","role","groups","responsibleCount","joinedAt","status"],"additionalProperties":false}},"required":["member"],"additionalProperties":false} ## 移除工作区成员 (memberRemove) DELETE /api/orgs/:orgId/members/:userId API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/memberRemove 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"clearResponsibilities":{"type":"boolean","const":true}},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 退出工作区 (organizationLeave) POST /api/orgs/:orgId/leave API Key：不支持，仅浏览器会话 权限：工作区普通成员或管理员；所有者须先转让所有权，退出前须交接责任 文档：/docs/organizationLeave 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 转让工作区 (organizationTransfer) POST /api/orgs/:orgId/transfer API Key：不支持，仅浏览器会话 权限：工作区所有者；目标成员必须有效，受交接规则约束 文档：/docs/organizationTransfer 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"userId":{"type":"string","minLength":1,"maxLength":32}},"required":["userId"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 邀请列表 (invitations) GET /api/orgs/:orgId/invitations API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/invitations 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"createdById":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"revokedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"usedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"usedById":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","createdById","createdAt","expiresAt","revokedAt","usedAt","usedById"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 创建成员邀请 (invitationCreate) POST /api/orgs/:orgId/invitations API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/invitationCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"invitation":{"type":"object","properties":{"id":{"type":"string"},"createdById":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"revokedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"usedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"usedById":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","createdById","createdAt","expiresAt","revokedAt","usedAt","usedById"],"additionalProperties":false},"token":{"type":"string"}},"required":["invitation","token"],"additionalProperties":false} ## 撤销成员邀请 (invitationRevoke) DELETE /api/orgs/:orgId/invitations/:id API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/invitationRevoke 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 查看成员邀请 (invitation) GET /api/invitations/:token API Key：不支持，仅浏览器会话 权限：无需登录；仅返回公开状态或当前会话摘要 文档：/docs/invitation 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"organizationName":{"type":"string"},"status":{"type":"string","enum":["valid","revoked","used","expired","suspended"]},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["organizationName","status","expiresAt"],"additionalProperties":false} ## 接受成员邀请 (invitationAccept) POST /api/invitations/:token/accept API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/invitationAccept 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"organizationId":{"type":"string"}},"required":["organizationId"],"additionalProperties":false} ## 工作区操作日志 (audit) GET /api/orgs/:orgId/audit-logs API Key：支持 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/audit 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"action":{"type":"string","maxLength":80},"actorId":{"type":"string","maxLength":32},"organizationId":{"type":"string","maxLength":32},"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"actorId":{"anyOf":[{"type":"string"},{"type":"null"}]},"actorName":{"type":"string"},"organizationId":{"anyOf":[{"type":"string"},{"type":"null"}]},"action":{"type":"string"},"targetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"result":{"type":"string"},"details":{},"requestId":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","actorId","actorName","organizationId","action","targetId","result","details","requestId","createdAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 工作区积分账单 (points) GET /api/orgs/:orgId/point-entries API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/points 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"delta":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"balance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"amountFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"description":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","delta","balance","amountFen","description","createdAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 同步统一账号资料 (profileSync) POST /api/auth/profile/sync API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/profileSync 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"nickname":{"type":"string"},"status":{"type":"string","enum":["active","suspended"]},"isPlatformAdmin":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"phoneMasked":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","accountId","nickname","status","isPlatformAdmin","createdAt"],"additionalProperties":false}},"required":["user"],"additionalProperties":false},{"type":"object","properties":{"reauthorize":{"type":"boolean","const":true}},"required":["reauthorize"],"additionalProperties":false}]} ## 当前登录用户 (me) GET /api/auth/me API Key：支持 权限：无需登录；仅返回公开状态或当前会话摘要 文档：/docs/me 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"user":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"accountId":{"type":"string"},"nickname":{"type":"string"},"status":{"type":"string","enum":["active","suspended"]},"isPlatformAdmin":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"phoneMasked":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","accountId","nickname","status","isPlatformAdmin","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["user"],"additionalProperties":false} ## 退出登录 (logout) POST /api/auth/logout API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/logout 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 素人档案列表 (creatorsList) GET /api/orgs/:orgId/creators API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/creatorsList 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100},"archived":{"default":"false","type":"string","enum":["all","true","false"]},"groupId":{"type":"string","maxLength":32},"responsibleUserId":{"type":"string","maxLength":32},"mine":{"default":"false","type":"string","enum":["true","false"]}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"reviewStatus":{"type":"string"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"notes":{"type":"string"},"archived":{"type":"boolean"},"groupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"groupName":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"needsHandoff":{"type":"boolean"},"canEdit":{"type":"boolean"},"canAssign":{"type":"boolean"},"createdById":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["reviewStatus","loginUserId","id","organizationId","name","platform","account","notes","archived","groupId","responsibleUserId","groupName","responsibleName","needsHandoff","canEdit","canAssign","createdById","createdAt","updatedAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 素人档案详情 (creatorsGet) GET /api/orgs/:orgId/creators/:id API Key：支持 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/creatorsGet 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creator":{"type":"object","properties":{"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"reviewStatus":{"type":"string"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"notes":{"type":"string"},"archived":{"type":"boolean"},"groupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"groupName":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"needsHandoff":{"type":"boolean"},"canEdit":{"type":"boolean"},"canAssign":{"type":"boolean"},"createdById":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["reviewStatus","loginUserId","id","organizationId","name","platform","account","notes","archived","groupId","responsibleUserId","groupName","responsibleName","needsHandoff","canEdit","canAssign","createdById","createdAt","updatedAt"],"additionalProperties":false}},"required":["creator"],"additionalProperties":false} ## 创建素人档案 (creatorsCreate) POST /api/orgs/:orgId/creators API Key：支持 权限：工作区成员；普通成员必须选择自己参与的小组 文档：/docs/creatorsCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"platform":{"default":"","type":"string","maxLength":40},"account":{"default":"","type":"string","maxLength":120},"groupId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]},"responsibleUserId":{"anyOf":[{"type":"string","minLength":1,"maxLength":32},{"type":"null"}]},"idNumber":{"default":"","type":"string","maxLength":18},"phone":{"default":"","type":"string","maxLength":32},"wechat":{"default":"","type":"string","maxLength":120},"email":{"default":"","type":"string","maxLength":254},"alipayQrCode":{"default":"","type":"string","maxLength":700000},"rating":{"default":"","type":"string","enum":["","S","A","B","C","D"]},"notes":{"default":"","type":"string","maxLength":2000}},"required":["name"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creator":{"type":"object","properties":{"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"reviewStatus":{"type":"string"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"notes":{"type":"string"},"archived":{"type":"boolean"},"groupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"groupName":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"needsHandoff":{"type":"boolean"},"canEdit":{"type":"boolean"},"canAssign":{"type":"boolean"},"createdById":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["reviewStatus","loginUserId","id","organizationId","name","platform","account","notes","archived","groupId","responsibleUserId","groupName","responsibleName","needsHandoff","canEdit","canAssign","createdById","createdAt","updatedAt"],"additionalProperties":false}},"required":["creator"],"additionalProperties":false} ## 修改素人档案 (creatorsUpdate) PATCH /api/orgs/:orgId/creators/:id API Key：支持 权限：所有者、管理员或所在小组成员；归档和恢复仅管理员 文档：/docs/creatorsUpdate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"idNumber":{"type":"string","maxLength":18},"phone":{"type":"string","maxLength":32},"wechat":{"type":"string","maxLength":120},"email":{"type":"string","maxLength":254},"alipayQrCode":{"type":"string","maxLength":700000},"rating":{"type":"string","enum":["","S","A","B","C","D"]},"platform":{"type":"string","maxLength":40},"account":{"type":"string","maxLength":120},"notes":{"type":"string","maxLength":2000},"archived":{"type":"boolean"}},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creator":{"type":"object","properties":{"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"reviewStatus":{"type":"string"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"notes":{"type":"string"},"archived":{"type":"boolean"},"groupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"groupName":{"anyOf":[{"type":"string"},{"type":"null"}]},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"needsHandoff":{"type":"boolean"},"canEdit":{"type":"boolean"},"canAssign":{"type":"boolean"},"createdById":{"type":"string"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["reviewStatus","loginUserId","id","organizationId","name","platform","account","notes","archived","groupId","responsibleUserId","groupName","responsibleName","needsHandoff","canEdit","canAssign","createdById","createdAt","updatedAt"],"additionalProperties":false}},"required":["creator"],"additionalProperties":false} ## 会员套餐 (plans) GET /api/membership-plans API Key：不支持，仅浏览器会话 权限：当前有效登录用户 文档：/docs/plans 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":50},"priceFen":{"type":"integer","minimum":0,"maximum":100000000},"yearPriceFen":{"type":"integer","minimum":0,"maximum":100000000},"memberLimit":{"type":"integer","minimum":1,"maximum":100000},"enabled":{"type":"boolean"},"id":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,19}$"}},"required":["name","priceFen","yearPriceFen","memberLimit","enabled","id"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false} ## 工作区会员权益 (billing) GET /api/orgs/:orgId/billing API Key：不支持，仅浏览器会话 权限：当前有效工作区成员；工作区及账号必须有效 文档：/docs/billing 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,19}$"},"planName":{"type":"string"},"memberLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"memberCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"nextPlan":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9-]{1,19}$"},{"type":"null"}]},"nextStartsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"points":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["plan","planName","memberLimit","memberCount","expiresAt","nextPlan","nextStartsAt","points"],"additionalProperties":false} ## 会员订单列表 (orders) GET /api/orgs/:orgId/membership-orders API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/orders 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991},"pageSize":{"default":20,"type":"integer","minimum":1,"maximum":100},"q":{"default":"","type":"string","maxLength":100}}} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"plan":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,19}$"},"planName":{"type":"string"},"memberLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"amountFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"period":{"type":"string","enum":["month","year"]},"source":{"type":"string","enum":["purchase","grant"]},"status":{"type":"string","enum":["pending","paid","cancelled","granted"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"paidAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"organization":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false}},"required":["id","organizationId","plan","planName","memberLimit","amountFen","period","source","status","createdAt","paidAt","startsAt","expiresAt"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["items","total","page","pageSize"],"additionalProperties":false} ## 创建会员订单 (orderCreate) POST /api/orgs/:orgId/membership-orders API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/orderCreate 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,19}$"},"period":{"default":"month","type":"string","enum":["month","year"]}},"required":["plan"],"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string"},"organizationId":{"type":"string"},"plan":{"type":"string","pattern":"^[a-z][a-z0-9-]{1,19}$"},"planName":{"type":"string"},"memberLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"amountFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"period":{"type":"string","enum":["month","year"]},"source":{"type":"string","enum":["purchase","grant"]},"status":{"type":"string","enum":["pending","paid","cancelled","granted"]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"paidAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"startsAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"organization":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"],"additionalProperties":false}},"required":["id","organizationId","plan","planName","memberLimit","amountFen","period","source","status","createdAt","paidAt","startsAt","expiresAt"],"additionalProperties":false}},"required":["order"],"additionalProperties":false} ## 取消会员订单 (orderCancel) POST /api/orgs/:orgId/membership-orders/:id/cancel API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/orderCancel 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false} ## 切换免费版本 (membershipFree) POST /api/orgs/:orgId/membership/free API Key：不支持，仅浏览器会话 权限：工作区所有者或管理员；受业务状态及交接规则约束 文档：/docs/membershipFree 请求 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false} 响应 JSON Schema： {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false}