# 素人种草 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} ## 调整作品费用(增加/扣减) (cooperationAdjustAmount) POST /api/orgs/:orgId/settlements/:id/adjustments API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/cooperationAdjustAmount 请求 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},"direction":{"type":"string","enum":["increase","decrease"]}},"required":["requestId","amountFen","direction"],"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} ## 项目进度与待办 (projectManagement) GET /api/orgs/:orgId/project-management API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/projectManagement 请求 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},"issueKind":{"type":"string","enum":["overdue","review","rework","fee"]},"issuePage":{"default":1,"type":"integer","minimum":1,"maximum":1000000}}} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projects":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"name":{"type":"string"},"status":{"type":"string"},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"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])))$"},"daysRemaining":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"plannedTasks":{"type":"integer","minimum":0,"maximum":9007199254740991},"completedTasks":{"type":"integer","minimum":0,"maximum":9007199254740991},"recoveredCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"approvedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingReviewCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"reworkCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFeeCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"overdueCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"confirmedFeeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"budgetFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","name","status","responsibleName","endsOn","daysRemaining","plannedTasks","completedTasks","recoveredCount","approvedCount","pendingReviewCount","reworkCount","pendingFeeCount","overdueCount","confirmedFeeFen","budgetFen"],"additionalProperties":false}}},"required":["total","page","pageSize","items"],"additionalProperties":false},"issues":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"counts":{"type":"object","properties":{"overdue":{"type":"integer","minimum":0,"maximum":9007199254740991},"review":{"type":"integer","minimum":0,"maximum":9007199254740991},"rework":{"type":"integer","minimum":0,"maximum":9007199254740991},"fee":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["overdue","review","rework","fee"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"kind":{"type":"string","enum":["overdue","review","rework","fee"]},"projectId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"creatorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"occurredAt":{"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))$"},"targetId":{"type":"string","minLength":1,"maxLength":32}},"required":["id","kind","projectId","projectName","responsibleName","title","creatorName","occurredAt","targetId"],"additionalProperties":false}}},"required":["total","page","pageSize","counts","items"],"additionalProperties":false}},"required":["projects","issues"],"additionalProperties":false} ## 项目运营报表 (projectReport) GET /api/orgs/:orgId/project-report API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/projectReport 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"projectId":{"type":"string","minLength":1,"maxLength":32},"status":{"type":"string","enum":["pending","partial","paid","overpaid","reversed"]},"from":{"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])))$"},"to":{"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])))$"}}} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"effects":{"type":"object","properties":{"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCoverage":{"type":"integer","minimum":0,"maximum":9007199254740991},"collectCoverage":{"type":"integer","minimum":0,"maximum":9007199254740991},"commentCoverage":{"type":"integer","minimum":0,"maximum":9007199254740991},"coveredCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"latestFetchedAt":{"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"}]},"rankings":{"type":"object","properties":{"diggCount":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"title":{"type":"string"},"creatorName":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"confirmedFeeFen":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"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"}]},"playCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","title","creatorName","platform","contentUrl","confirmedFeeFen","fetchedAt","playCount","diggCount","collectCount","commentCount"],"additionalProperties":false}},"collectCount":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"title":{"type":"string"},"creatorName":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"confirmedFeeFen":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"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"}]},"playCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","title","creatorName","platform","contentUrl","confirmedFeeFen","fetchedAt","playCount","diggCount","collectCount","commentCount"],"additionalProperties":false}},"commentCount":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"title":{"type":"string"},"creatorName":{"type":"string"},"platform":{"type":"string"},"contentUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"confirmedFeeFen":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"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"}]},"playCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"diggCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"collectCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"commentCount":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["id","title","creatorName","platform","contentUrl","confirmedFeeFen","fetchedAt","playCount","diggCount","collectCount","commentCount"],"additionalProperties":false}}},"required":["diggCount","collectCount","commentCount"],"additionalProperties":false}},"required":["diggCount","collectCount","commentCount","diggCoverage","collectCoverage","commentCoverage","coveredCount","latestFetchedAt","rankings"],"additionalProperties":false},"summary":{"type":"object","properties":{"recoveredCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"creatorCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"confirmedFeeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"averageFeeFen":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"overpaidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"settledCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"unsettledCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["recoveredCount","creatorCount","confirmedFeeFen","averageFeeFen","pendingFen","overpaidFen","settledCount","unsettledCount"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"date":{"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])))$"},"payableFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"recoveredCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["date","payableFen","recoveredCount"],"additionalProperties":false}}},"required":["effects","summary","items"],"additionalProperties":false} ## projectSettlementCreators (projectSettlementCreators) GET /api/orgs/:orgId/project-settlements API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/projectSettlementCreators 请求 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},"status":{"default":"all","type":"string","enum":["all","pending","paid"]}}} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"projectId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"creatorId":{"type":"string","minLength":1,"maxLength":32},"creatorName":{"type":"string"},"confirmedFeeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"walletBalanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"payableFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["projectId","projectName","creatorId","creatorName","confirmedFeeFen","paidFen","balanceFen","walletBalanceFen","payableFen"],"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} ## projectSettlementCreator (projectSettlementCreator) GET /api/orgs/:orgId/projects/:projectId/settlement-creators/:id API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/projectSettlementCreator 请求 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":{"summary":{"type":"object","properties":{"projectId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"creatorId":{"type":"string","minLength":1,"maxLength":32},"creatorName":{"type":"string"},"confirmedFeeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"walletBalanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"payableFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["projectId","projectName","creatorId","creatorName","confirmedFeeFen","paidFen","balanceFen","walletBalanceFen","payableFen"],"additionalProperties":false},"alipayQrCode":{"type":"string"},"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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"overpaidFen":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","overpaid","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","overpaidFen","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}},"required":["summary","alipayQrCode","items","total","page","pageSize"],"additionalProperties":false} ## projectSettlementPayments (projectSettlementPayments) GET /api/orgs/:orgId/projects/:projectId/settlement-creators/:id/payments API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/projectSettlementPayments 请求 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},"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}},"projectAmountFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","amountFen","note","createdByName","createdAt","reversedAt","reversedByName","reversalReason","allocations","projectAmountFen"],"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} ## 项目结算列表 (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","overpaid","reversed"]},"from":{"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])))$"},"to":{"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])))$"}}} 响应 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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"overpaidFen":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","overpaid","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","overpaidFen","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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"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","settlement_deduction"]},"amountFen":{"type":"integer","minimum":-9007199254740991,"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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"overpaidFen":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","overpaid","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","overpaidFen","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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"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","settlement_deduction","payment","payment_reversal"]},"deltaFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"overpaidFen":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","overpaid","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","overpaidFen","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},"projectId":{"type":"string","minLength":1,"maxLength":32}},"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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"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","settlement_deduction","payment","payment_reversal"]},"deltaFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"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":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"overpaidFen":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","partial","paid","overpaid","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","overpaidFen","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":{"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"},"reviewStatus":{"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":["shareToken","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":{"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"},"reviewStatus":{"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":["shareToken","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":{"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"},"reviewStatus":{"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":["shareToken","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":{"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"},"reviewStatus":{"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":["shareToken","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"},"reviewStatus":{"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"},"reviewStatus":{"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"},"reviewStatus":{"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"},"reviewStatus":{"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":{"shareToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"},"reviewStatus":{"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":["shareToken","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} ## 计划统一领取概要 (planShareGet) GET /api/publishing-plan-shares/:token API Key:不支持,仅浏览器会话 权限:匿名可查看计划概要和剩余数量;登录后返回本人今日领取状态 文档:/docs/planShareGet 请求 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"}},"required":["name"],"additionalProperties":false},"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))$"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"remaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"videoCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"imageTextCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"availability":{"type":"string","enum":["available","daily_limited","exhausted","expired","stopped"]},"todayTaskToken":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["organization","project","deadline","total","remaining","videoCount","imageTextCount","availability","todayTaskToken"],"additionalProperties":false} ## 自动领取计划任务 (planShareClaim) POST /api/publishing-plan-shares/:token/claim API Key:不支持,仅浏览器会话 权限:统一登录用户;任务有效,每工作区按北京时间每天最多领取一条 文档:/docs/planShareClaim 请求 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":{"token":{"type":"string"}},"required":["token"],"additionalProperties":false} ## browserTransferCreate (browserTransferCreate) POST /api/auth/browser-transfer API Key:不支持,仅浏览器会话 权限:当前有效登录用户 文档:/docs/browserTransferCreate 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"shareToken":{"type":"string","minLength":1,"maxLength":64}},"required":["shareToken"],"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"url":{"type":"string"},"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":["url","expiresAt"],"additionalProperties":false} ## browserTransferInspect (browserTransferInspect) POST /api/auth/browser-transfer/inspect API Key:不支持,仅浏览器会话 权限:当前有效登录用户 文档:/docs/browserTransferInspect 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ticket":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"}},"required":["ticket"],"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string"},"nickname":{"type":"string"}},"required":["id","nickname"],"additionalProperties":false},"currentUser":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"nickname":{"type":"string"}},"required":["id","nickname"],"additionalProperties":false},{"type":"null"}]},"project":{"type":"string"},"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))$"},"remainingSeconds":{"type":"integer","minimum":0,"maximum":300}},"required":["user","currentUser","project","expiresAt","remainingSeconds"],"additionalProperties":false} ## browserTransferConsume (browserTransferConsume) POST /api/auth/browser-transfer/consume API Key:不支持,仅浏览器会话 权限:当前有效登录用户 文档:/docs/browserTransferConsume 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ticket":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"},"userId":{"type":"string","maxLength":32},"currentUserId":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}]}},"required":["ticket","userId","currentUserId"],"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"next":{"type":"string"}},"required":["next"],"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":{"id":{"type":"string"},"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","daily_limited"]},"todayTaskToken":{"anyOf":[{"type":"string"},{"type":"null"}]},"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"},"reviewStatus":{"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","todayTaskToken"],"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":1,"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":1,"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} ## myCooperationWorkspaces (myCooperationWorkspaces) GET /api/my/cooperation-workspaces API Key:不支持,仅浏览器会话 权限:当前有效登录用户 文档:/docs/myCooperationWorkspaces 请求 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"},"walletIds":{"type":"array","items":{"type":"string"}}},"required":["id","name","walletIds"],"additionalProperties":false}}},"required":["items"],"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},"organizationId":{"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":{"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},"reviewStatus":{"type":"string","enum":["pending","approved","suspended"]}}} 响应 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} ## 素人评级详情 (creatorRatingGet) GET /api/orgs/:orgId/creators/:id/rating API Key:支持 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/creatorRatingGet 请求 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":{"rating":{"type":"string","enum":["D","C","B","A","S"]},"autoRating":{"type":"string","enum":["C","B","A"]},"ratingMode":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"operatorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"ratedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"eligible":{"type":"boolean"},"ruleVersion":{"type":"number"},"rules":{"type":"object","properties":{"B":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false},"A":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false}},"required":["B","A"],"additionalProperties":false},"evaluation":{"type":"object","properties":{"suggested":{"type":"string","enum":["C","B","A"]},"stats":{"type":"object","properties":{"works":{"type":"number"},"incomeFen":{"type":"number"},"completeEffectWorks":{"type":"number"},"incompleteEffectWorks":{"type":"number"},"effectWorksB":{"type":"number"},"effectWorksA":{"type":"number"}},"required":["works","incomeFen","completeEffectWorks","incompleteEffectWorks","effectWorksB","effectWorksA"],"additionalProperties":false},"progress":{"type":"array","items":{"type":"object","properties":{"grade":{"type":"string","enum":["C","B","A"]},"works":{"type":"number"},"requiredWorks":{"type":"number"},"incomeBonus":{"type":"boolean"},"effectBonus":{"type":"boolean"},"effectWorks":{"type":"number"},"threshold":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false}},"required":["grade","works","requiredWorks","incomeBonus","effectBonus","effectWorks","threshold"],"additionalProperties":false}}},"required":["suggested","stats","progress"],"additionalProperties":false}},"required":["rating","autoRating","ratingMode","reason","operatorName","ratedAt","eligible","ruleVersion","rules","evaluation"],"additionalProperties":false} ## 人工评定或恢复自动评级 (creatorRatingUpdate) PATCH /api/orgs/:orgId/creators/:id/rating API Key:支持 权限:工作区所有者或管理员;受业务状态及交接规则约束 文档:/docs/creatorRatingUpdate 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"manual"},"rating":{"type":"string","enum":["D","C","B","A","S"]},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["mode","rating","reason"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"auto"}},"required":["mode"],"additionalProperties":false}]} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rating":{"type":"string","enum":["D","C","B","A","S"]},"autoRating":{"type":"string","enum":["C","B","A"]},"ratingMode":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"operatorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"ratedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"eligible":{"type":"boolean"},"ruleVersion":{"type":"number"},"rules":{"type":"object","properties":{"B":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false},"A":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false}},"required":["B","A"],"additionalProperties":false},"evaluation":{"type":"object","properties":{"suggested":{"type":"string","enum":["C","B","A"]},"stats":{"type":"object","properties":{"works":{"type":"number"},"incomeFen":{"type":"number"},"completeEffectWorks":{"type":"number"},"incompleteEffectWorks":{"type":"number"},"effectWorksB":{"type":"number"},"effectWorksA":{"type":"number"}},"required":["works","incomeFen","completeEffectWorks","incompleteEffectWorks","effectWorksB","effectWorksA"],"additionalProperties":false},"progress":{"type":"array","items":{"type":"object","properties":{"grade":{"type":"string","enum":["C","B","A"]},"works":{"type":"number"},"requiredWorks":{"type":"number"},"incomeBonus":{"type":"boolean"},"effectBonus":{"type":"boolean"},"effectWorks":{"type":"number"},"threshold":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false}},"required":["grade","works","requiredWorks","incomeBonus","effectBonus","effectWorks","threshold"],"additionalProperties":false}}},"required":["suggested","stats","progress"],"additionalProperties":false}},"required":["rating","autoRating","ratingMode","reason","operatorName","ratedAt","eligible","ruleVersion","rules","evaluation"],"additionalProperties":false} ## 读取工作区评级规则 (creatorRatingRulesGet) GET /api/orgs/:orgId/creator-rating-rules API Key:支持 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/creatorRatingRulesGet 请求 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":{"rules":{"type":"object","properties":{"B":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false},"A":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false}},"required":["B","A"],"additionalProperties":false},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rules","version"],"additionalProperties":false} ## 保存工作区评级规则 (creatorRatingRulesUpdate) PATCH /api/orgs/:orgId/creator-rating-rules API Key:支持 权限:工作区所有者或管理员;受业务状态及交接规则约束 文档:/docs/creatorRatingRulesUpdate 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rules":{"type":"object","properties":{"B":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false},"A":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false}},"required":["B","A"],"additionalProperties":false},"version":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["rules","version"],"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"rules":{"type":"object","properties":{"B":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false},"A":{"type":"object","properties":{"works":{"type":"integer","minimum":1,"maximum":1000000},"incomeFen":{"type":"integer","minimum":1,"maximum":2000000000},"effectWorks":{"type":"integer","minimum":1,"maximum":1000000},"interactions":{"type":"integer","minimum":1,"maximum":1000000000}},"required":["works","incomeFen","effectWorks","interactions"],"additionalProperties":false}},"required":["B","A"],"additionalProperties":false},"version":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rules","version"],"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"]}},"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} ## 暂停或恢复素人合作 (creatorStatus) PATCH /api/orgs/:orgId/creators/:id/status API Key:支持 权限:工作区所有者或管理员;受业务状态及交接规则约束 文档:/docs/creatorStatus 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"suspended":{"type":"boolean"}},"required":["suspended"],"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} ## recoveredContentBatchReview (recoveredContentBatchReview) POST /api/orgs/:orgId/recovered-contents/batch-review API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/recoveredContentBatchReview 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ids":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":32}},"includeRejected":{"default":false,"type":"boolean"}},"required":["ids"],"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","minLength":1,"maxLength":32},"status":{"type":"string","enum":["succeeded","skipped","failed"]},"message":{"type":"string"}},"required":["id","status","message"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false} ## recoveredContentBatchFees (recoveredContentBatchFees) POST /api/orgs/:orgId/recovered-contents/batch-fees API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/recoveredContentBatchFees 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"items":{"minItems":1,"maxItems":100,"type":"array","items":{"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},"id":{"type":"string","minLength":1,"maxLength":32}},"required":["requestId","amountFen","id"],"additionalProperties":false}}},"required":["items"],"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","minLength":1,"maxLength":32},"status":{"type":"string","enum":["succeeded","skipped","failed"]},"message":{"type":"string"}},"required":["id","status","message"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false} ## 审核回收内容 (recoveredContentReview) PATCH /api/orgs/:orgId/recovered-contents/:id/review API Key:不支持,仅浏览器会话 权限:当前有效工作区成员;工作区及账号必须有效 文档:/docs/recoveredContentReview 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reviewStatus":{"type":"string","enum":["pending","approved","rejected"]}},"required":["reviewStatus"],"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"updated":{"type":"boolean","const":true},"reviewStatus":{"type":"string","enum":["pending","approved","rejected"]},"reviewedAt":{"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"}]},"reviewedByName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["updated","reviewStatus","reviewedAt","reviewedByName"],"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"}]},"contentUrl":{"type":"string","maxLength":2000,"format":"uri"}},"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":{"refreshError":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewStatus":{"type":"string","enum":["pending","approved","rejected"]},"reviewedAt":{"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"}]},"reviewedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"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":["reviewStatus","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"]},"workStatus":{"type":"string","enum":["normal","abnormal","pending"]},"reviewStatus":{"type":"string","enum":["pending","approved","rejected"]},"sortBy":{"default":"collectedAt","type":"string","enum":["collectedAt","publishedAt","playCount","diggCount","collectCount","commentCount","shareCount"]},"sortDirection":{"default":"desc","type":"string","enum":["asc","desc"]},"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":{"refreshError":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewStatus":{"type":"string","enum":["pending","approved","rejected"]},"reviewedAt":{"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"}]},"reviewedByName":{"anyOf":[{"type":"string"},{"type":"null"}]},"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":["reviewStatus","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"}]},"responsibleGroupNames":{"type":"array","items":{"type":"string"}},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]}},"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","responsibleGroupNames","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"}]},"responsibleGroupNames":{"type":"array","items":{"type":"string"}},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]}},"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","responsibleGroupNames","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":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]},"platforms":{"minItems":1,"maxItems":5,"type":"array","items":{"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"],"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"}]},"responsibleGroupNames":{"type":"array","items":{"type":"string"}},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]}},"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","responsibleGroupNames","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":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]},"platforms":{"minItems":1,"maxItems":5,"type":"array","items":{"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"],"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"}]},"responsibleGroupNames":{"type":"array","items":{"type":"string"}},"startsOn":{"type":"string"},"endsOn":{"type":"string"},"budgetFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"platform":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["小红书","抖音","微信视频号","微信公众号","微信贴图","多平台"]}},"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","responsibleGroupNames","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} ## personalCreatorProfile (personalCreatorProfile) GET /api/auth/creator-profile API Key:不支持,仅浏览器会话 权限:当前有效登录用户 文档:/docs/personalCreatorProfile 请求 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":{"profile":{"anyOf":[{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"idNumber":{"default":"","type":"string","maxLength":18},"phone":{"default":"","type":"string","maxLength":32},"wechat":{"default":"","type":"string","maxLength":120},"email":{"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,}$"}]},"alipayQrCode":{"default":"","type":"string","maxLength":700000}},"required":["name","idNumber","phone","wechat","email","alipayQrCode"],"additionalProperties":false},{"type":"null"}]}},"required":["profile"],"additionalProperties":false} ## personalCreatorProfileSave (personalCreatorProfileSave) POST /api/auth/creator-profile API Key:不支持,仅浏览器会话 权限:当前有效登录用户 文档:/docs/personalCreatorProfileSave 请求 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"idNumber":{"default":"","type":"string","maxLength":18},"phone":{"default":"","type":"string","maxLength":32},"wechat":{"default":"","type":"string","maxLength":120},"email":{"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,}$"}]},"alipayQrCode":{"default":"","type":"string","maxLength":700000}},"required":["name","email"],"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profile":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"idNumber":{"default":"","type":"string","maxLength":18},"phone":{"default":"","type":"string","maxLength":32},"wechat":{"default":"","type":"string","maxLength":120},"email":{"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,}$"}]},"alipayQrCode":{"default":"","type":"string","maxLength":700000}},"required":["name","idNumber","phone","wechat","email","alipayQrCode"],"additionalProperties":false}},"required":["profile"],"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":{"period":{"default":"month","type":"string","enum":["month","7d","30d"]},"issueKind":{"type":"string","enum":["overdue","review","rework","fee"]}}} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"period":{"type":"object","properties":{"from":{"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])))$"},"to":{"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])))$"},"recovered":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"approved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["from","to","recovered","approved"],"additionalProperties":false},"finance":{"type":"object","properties":{"confirmedFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pendingFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"overpaidFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"overBudgetProjects":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["confirmedFen","paidFen","pendingFen","overpaidFen","overBudgetProjects"],"additionalProperties":false},"management":{"type":"object","properties":{"projects":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"name":{"type":"string"},"status":{"type":"string"},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"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])))$"},"daysRemaining":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"plannedTasks":{"type":"integer","minimum":0,"maximum":9007199254740991},"completedTasks":{"type":"integer","minimum":0,"maximum":9007199254740991},"recoveredCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"approvedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingReviewCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"reworkCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"pendingFeeCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"overdueCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"confirmedFeeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"budgetFen":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","name","status","responsibleName","endsOn","daysRemaining","plannedTasks","completedTasks","recoveredCount","approvedCount","pendingReviewCount","reworkCount","pendingFeeCount","overdueCount","confirmedFeeFen","budgetFen"],"additionalProperties":false}}},"required":["total","page","pageSize","items"],"additionalProperties":false},"issues":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"page":{"type":"integer","minimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"counts":{"type":"object","properties":{"overdue":{"type":"integer","minimum":0,"maximum":9007199254740991},"review":{"type":"integer","minimum":0,"maximum":9007199254740991},"rework":{"type":"integer","minimum":0,"maximum":9007199254740991},"fee":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["overdue","review","rework","fee"],"additionalProperties":false},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":32},"kind":{"type":"string","enum":["overdue","review","rework","fee"]},"projectId":{"type":"string","minLength":1,"maxLength":32},"projectName":{"type":"string"},"responsibleName":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"creatorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"occurredAt":{"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))$"},"targetId":{"type":"string","minLength":1,"maxLength":32}},"required":["id","kind","projectId","projectName","responsibleName","title","creatorName","occurredAt","targetId"],"additionalProperties":false}}},"required":["total","page","pageSize","counts","items"],"additionalProperties":false}},"required":["projects","issues"],"additionalProperties":false},"dueSoon":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"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":["period","finance","management","dueSoon","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"}]},"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxUses":{"type":"number","const":10}},"required":["id","createdById","createdAt","expiresAt","revokedAt","usedAt","usedById","useCount","maxUses"],"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"}]},"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxUses":{"type":"number","const":10}},"required":["id","createdById","createdAt","expiresAt","revokedAt","usedAt","usedById","useCount","maxUses"],"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":{"useCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxUses":{"type":"number","const":10},"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":["useCount","maxUses","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},"reviewStatus":{"type":"string","enum":["pending","approved"]},"suspended":{"type":"string","enum":["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":{"currentPersonalName":{"anyOf":[{"type":"string"},{"type":"null"}]},"cooperationSummary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false},"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"autoRating":{"type":"string"},"ratingMode":{"type":"string","enum":["auto","manual"]},"reviewStatus":{"type":"string"},"suspended":{"type":"boolean"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"accountCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"notes":{"type":"string"},"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":["cooperationSummary","reviewStatus","suspended","loginUserId","id","organizationId","name","platform","account","accountCount","notes","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":{"currentPersonalName":{"anyOf":[{"type":"string"},{"type":"null"}]},"cooperationSummary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false},"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"autoRating":{"type":"string"},"ratingMode":{"type":"string","enum":["auto","manual"]},"reviewStatus":{"type":"string"},"suspended":{"type":"boolean"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"accountCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"notes":{"type":"string"},"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","suspended","loginUserId","id","organizationId","name","platform","account","accountCount","notes","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},"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":{"currentPersonalName":{"anyOf":[{"type":"string"},{"type":"null"}]},"cooperationSummary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false},"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"autoRating":{"type":"string"},"ratingMode":{"type":"string","enum":["auto","manual"]},"reviewStatus":{"type":"string"},"suspended":{"type":"boolean"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"accountCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"notes":{"type":"string"},"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","suspended","loginUserId","id","organizationId","name","platform","account","accountCount","notes","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},"platform":{"type":"string","maxLength":40},"account":{"type":"string","maxLength":120},"notes":{"type":"string","maxLength":2000}},"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"creator":{"type":"object","properties":{"currentPersonalName":{"anyOf":[{"type":"string"},{"type":"null"}]},"cooperationSummary":{"type":"object","properties":{"incomeFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"paidFen":{"type":"integer","minimum":0,"maximum":9007199254740991},"balanceFen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["incomeFen","paidFen","balanceFen"],"additionalProperties":false},"idNumber":{"type":"string"},"phone":{"type":"string"},"wechat":{"type":"string"},"email":{"type":"string"},"alipayQrCode":{"type":"string"},"rating":{"type":"string"},"autoRating":{"type":"string"},"ratingMode":{"type":"string","enum":["auto","manual"]},"reviewStatus":{"type":"string"},"suspended":{"type":"boolean"},"loginUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"platform":{"type":"string"},"account":{"type":"string"},"accountCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"notes":{"type":"string"},"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","suspended","loginUserId","id","organizationId","name","platform","account","accountCount","notes","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","refunded"]},"paymentMode":{"type":"string","enum":["central","manual","grant"]},"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","paymentMode","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} ## membershipCheckout (membershipCheckout) POST /api/orgs/:orgId/membership-checkout API Key:不支持,仅浏览器会话 权限:工作区所有者或管理员;受业务状态及交接规则约束 文档:/docs/membershipCheckout 请求 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":{"type":"string","enum":["month","year"]},"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":["plan","period","requestId"],"additionalProperties":false} 响应 JSON Schema: {"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"orderId":{"type":"string"},"checkoutUrl":{"type":"string","format":"uri"}},"required":["orderId","checkoutUrl"],"additionalProperties":false} ## membershipCheckoutResume (membershipCheckoutResume) POST /api/orgs/:orgId/membership-orders/:id/checkout API Key:不支持,仅浏览器会话 权限:工作区所有者或管理员;受业务状态及交接规则约束 文档:/docs/membershipCheckoutResume 请求 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":{"orderId":{"type":"string"},"checkoutUrl":{"type":"string","format":"uri"}},"required":["orderId","checkoutUrl"],"additionalProperties":false} ## membershipPaymentSync (membershipPaymentSync) POST /api/membership-payments/:id/sync API Key:不支持,仅浏览器会话 权限:工作区所有者或管理员;受业务状态及交接规则约束 文档:/docs/membershipPaymentSync 请求 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"},"status":{"type":"string","enum":["pending","paid","cancelled","refunded"]}},"required":["organizationId","status"],"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","refunded"]},"paymentMode":{"type":"string","enum":["central","manual","grant"]},"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","paymentMode","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}