{"openapi":"3.1.0","info":{"title":"灵途小工单 API","version":"1.0.0","description":"统一 Key 鉴权，沿用本人空间权限。首次使用请先网页登录。"},"servers":[{"url":"https://xgd.ailingtu.cn"}],"paths":{"/api/v1/me":{"get":{"operationId":"me","tags":["开始使用"],"summary":"查询本人身份","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/me"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces":{"get":{"operationId":"spaces","tags":["开始使用"],"summary":"查询可访问空间","security":[{"bearerAuth":[]}],"parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/spaces"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/members":{"get":{"operationId":"members","tags":["空间"],"summary":"查询成员公开资料","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/members"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets":{"get":{"operationId":"tickets.list","tags":["工单"],"summary":"查询工单列表","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"view","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/tickets"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"tickets.create","tags":["工单"],"summary":"发布工单","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"content":{"type":"string","maxLength":50000},"attachmentIds":{"type":"array","items":{"type":"string"}},"assigneeId":{"type":"string","maxLength":50000}},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets/{id}":{"get":{"operationId":"tickets.get","tags":["工单"],"summary":"查询工单详情","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/tickets"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"tickets.edit","tags":["工单"],"summary":"编辑原始内容","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"content":{"type":"string","maxLength":50000},"attachmentIds":{"type":"array","items":{"type":"string"}}},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers":{"get":{"operationId":"customers.list","tags":["客户"],"summary":"查询客户列表","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"managerId","in":"query","schema":{"type":"string"}},{"name":"followUp","in":"query","schema":{"type":"string"}},{"name":"membership","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/customers"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"customers.create","tags":["客户"],"summary":"按手机号录入客户","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"phone":{"type":"string","maxLength":50000}},"required":["phone"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers/{id}":{"get":{"operationId":"customers.get","tags":["客户"],"summary":"查询客户详情","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/customers"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"customers.update","tags":["客户"],"summary":"修改客户","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"externalCompanyId":{"type":"string","maxLength":50000},"companyName":{"type":"string","maxLength":50000},"contactEmails":{"type":"string","maxLength":50000},"remark":{"type":"string","maxLength":50000}},"required":["externalCompanyId","companyName"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"customers.delete","tags":["客户"],"summary":"删除客户","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/suppliers":{"get":{"operationId":"suppliers.list","tags":["供应商"],"summary":"查询供应商列表","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"search","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/suppliers"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"suppliers.create","tags":["供应商"],"summary":"新增供应商","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":50000},"taxId":{"type":"string","maxLength":50000},"bankAccount":{"type":"string","maxLength":50000},"bankName":{"type":"string","maxLength":50000},"contactPerson":{"type":"string","maxLength":50000},"contactPhone":{"type":"string","maxLength":50000},"address":{"type":"string","maxLength":50000},"remark":{"type":"string","maxLength":50000}},"required":["name"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/suppliers/{id}":{"get":{"operationId":"suppliers.get","tags":["供应商"],"summary":"查询供应商详情","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/suppliers"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"suppliers.update","tags":["供应商"],"summary":"修改供应商","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":50000},"taxId":{"type":"string","maxLength":50000},"bankAccount":{"type":"string","maxLength":50000},"bankName":{"type":"string","maxLength":50000},"contactPerson":{"type":"string","maxLength":50000},"contactPhone":{"type":"string","maxLength":50000},"address":{"type":"string","maxLength":50000},"remark":{"type":"string","maxLength":50000}},"required":["name"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"suppliers.delete","tags":["供应商"],"summary":"删除供应商","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/finance":{"get":{"operationId":"finance.list","tags":["收支"],"summary":"查询收支列表","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"recordType","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/finance"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"finance.create","tags":["收支"],"summary":"提交收支记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"recordType":{"type":"string","enum":["INCOME","EXPENSE"]},"reimbursementDate":{"type":"string","description":"YYYY-MM-DD","maxLength":50000},"fundAccount":{"type":"string","enum":["PERSONAL","CORPORATE"]},"description":{"type":"string","maxLength":50000},"amount":{"type":"string","description":"正数十进制字符串，最多两位小数","maxLength":50000},"supplierId":{"type":"string","maxLength":50000},"attachmentKey":{"type":"string","maxLength":50000},"attachmentName":{"type":"string","maxLength":50000}},"required":["reimbursementDate","fundAccount","description","amount"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/finance/{id}":{"get":{"operationId":"finance.get","tags":["收支"],"summary":"查询收支详情","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/finance"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"finance.update","tags":["收支"],"summary":"修改日期及说明","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"reimbursementDate":{"type":"string","maxLength":50000},"description":{"type":"string","maxLength":50000}},"required":["reimbursementDate","description"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tags":{"get":{"operationId":"tags.list","tags":["标签"],"summary":"查询标签列表","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"includeArchived","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/tags"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"tags.create","tags":["标签"],"summary":"新增标签","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":50000}},"required":["name"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tags/{id}":{"get":{"operationId":"tags.get","tags":["标签"],"summary":"查询标签详情","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/tags"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"tags.update","tags":["标签"],"summary":"重命名、归档或恢复标签","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","enum":["rename","archive","restore"]},"name":{"type":"string","maxLength":50000}},"required":["operation"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/community":{"get":{"operationId":"community.list","tags":["交流"],"summary":"查询交流列表","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"categoryId","in":"query","schema":{"type":"string"}},{"name":"parentId","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/community"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"community.create","tags":["交流"],"summary":"发布交流或回复","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"categoryId":{"type":"string","maxLength":50000},"content":{"type":"string","maxLength":50000},"parentPostId":{"type":"string","maxLength":50000},"publishedAt":{"type":"string","maxLength":50000},"uploadedMedia":{"type":"string","description":"附件上传返回的 media 数组序列化 JSON","maxLength":50000}},"required":["categoryId"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/community/{id}":{"get":{"operationId":"community.get","tags":["交流"],"summary":"查询交流详情","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/community"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"community.update","tags":["交流"],"summary":"编辑交流","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"content":{"type":"string","maxLength":50000}},"required":["content"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"community.delete","tags":["交流"],"summary":"删除交流","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets/{id}/comments":{"post":{"operationId":"tickets.comment","tags":["工单"],"summary":"补充跟进","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"content":{"type":"string","maxLength":50000},"attachmentIds":{"type":"array","items":{"type":"string"}}},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets/{id}/assign":{"post":{"operationId":"tickets.assign","tags":["工单"],"summary":"转派负责人","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"assigneeId":{"type":"string","maxLength":50000}},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets/{id}/claim":{"post":{"operationId":"tickets.claim","tags":["工单"],"summary":"认领工单","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets/{id}/status":{"post":{"operationId":"tickets.status","tags":["工单"],"summary":"调整状态","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["OPEN","IN_PROGRESS","DONE","CANCELLED"]}},"required":["status"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers/{id}/transfer":{"post":{"operationId":"customers.transfer","tags":["客户"],"summary":"转交客户","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"newManagerId":{"type":"string","maxLength":50000}},"required":["newManagerId"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers/{id}/reclaim":{"post":{"operationId":"customers.reclaim","tags":["客户"],"summary":"收回客户","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers/{id}/activities":{"get":{"operationId":"customers.activities","tags":["客户"],"summary":"查询跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/activities"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"customers.activity.create","tags":["客户"],"summary":"添加跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["TRAINING","CALL","MEETING","ONBOARDING","NEW_USER_EXPERIENCE","GIFT_POINTS","COMPENSATION_POINTS","RESET_PASSWORD","ISSUE","FEEDBACK","FOLLOW_UP","INVOICE","OTHER"]},"title":{"type":"string","maxLength":50000},"content":{"type":"string","maxLength":50000},"occurredAt":{"type":"string","description":"上海时区本地时间 YYYY-MM-DDTHH:mm","maxLength":50000},"attachmentKey":{"type":"string","maxLength":50000},"attachmentName":{"type":"string","maxLength":50000},"attachmentSize":{"type":"string","maxLength":50000},"attachmentMimeType":{"type":"string","maxLength":50000},"pointAmount":{"type":"string","maxLength":50000}},"required":["type","title","occurredAt"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers/{id}/activities/{activityId}":{"patch":{"operationId":"customers.activity.update","tags":["客户"],"summary":"编辑跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"activityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["TRAINING","CALL","MEETING","ONBOARDING","NEW_USER_EXPERIENCE","GIFT_POINTS","COMPENSATION_POINTS","RESET_PASSWORD","ISSUE","FEEDBACK","FOLLOW_UP","INVOICE","OTHER"]},"title":{"type":"string","maxLength":50000},"content":{"type":"string","maxLength":50000},"occurredAt":{"type":"string","description":"上海时区本地时间 YYYY-MM-DDTHH:mm","maxLength":50000}},"required":["type","title","occurredAt"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"customers.activity.delete","tags":["客户"],"summary":"删除跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"activityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/suppliers/{id}/activities":{"get":{"operationId":"suppliers.activities","tags":["供应商"],"summary":"查询跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/activities"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"suppliers.activity.create","tags":["供应商"],"summary":"添加跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["CALL","MEETING","FOLLOW_UP","CONTRACT","PAYMENT","INVOICE","ISSUE","OTHER"]},"title":{"type":"string","maxLength":50000},"content":{"type":"string","maxLength":50000},"occurredAt":{"type":"string","description":"上海时区本地时间 YYYY-MM-DDTHH:mm","maxLength":50000},"attachmentKey":{"type":"string","maxLength":50000},"attachmentName":{"type":"string","maxLength":50000},"attachmentSize":{"type":"string","maxLength":50000},"attachmentMimeType":{"type":"string","maxLength":50000}},"required":["type","title","occurredAt"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/suppliers/{id}/activities/{activityId}":{"patch":{"operationId":"suppliers.activity.update","tags":["供应商"],"summary":"编辑跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"activityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["CALL","MEETING","FOLLOW_UP","CONTRACT","PAYMENT","INVOICE","ISSUE","OTHER"]},"title":{"type":"string","maxLength":50000},"content":{"type":"string","maxLength":50000},"occurredAt":{"type":"string","description":"上海时区本地时间 YYYY-MM-DDTHH:mm","maxLength":50000}},"required":["type","title","occurredAt"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"operationId":"suppliers.activity.delete","tags":["供应商"],"summary":"删除跟进记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"activityId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/finance/{id}/cancel":{"post":{"operationId":"finance.cancel","tags":["收支"],"summary":"作废并按既有规则冲销记录","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/finance/{id}/tags":{"post":{"operationId":"finance.tags","tags":["收支"],"summary":"更新收支标签","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"tagIds":{"type":"array","items":{"type":"string"}}},"required":[]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tag-report":{"get":{"operationId":"tags.report","tags":["标签"],"summary":"查询标签收支明细","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"tagId","in":"query","schema":{"type":"string"}},{"name":"untagged","in":"query","schema":{"type":"string"}},{"name":"startDate","in":"query","schema":{"type":"string"}},{"name":"endDate","in":"query","schema":{"type":"string"}},{"name":"categoryId","in":"query","schema":{"type":"string"}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"recordType","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/finance"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/community-categories":{"get":{"operationId":"community.categories","tags":["交流"],"summary":"查询可用栏目","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/community.categories"}}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/community/{id}/reactions":{"post":{"operationId":"community.react","tags":["交流"],"summary":"切换回应","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"type":{"type":"string","enum":["UPVOTE","DOWNVOTE"]}},"required":["type"]}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets/attachments":{"post":{"operationId":"tickets.upload","tags":["工单"],"summary":"上传附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/upload"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/tickets/attachments/{attachmentId}":{"get":{"operationId":"tickets.download","tags":["附件"],"summary":"下载附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"文件下载","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers/attachments":{"post":{"operationId":"customers.upload","tags":["客户"],"summary":"上传附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/upload"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/customers/attachments/{attachmentId}":{"get":{"operationId":"customers.download","tags":["附件"],"summary":"下载附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"文件下载","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/suppliers/attachments":{"post":{"operationId":"suppliers.upload","tags":["供应商"],"summary":"上传附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/upload"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/suppliers/attachments/{attachmentId}":{"get":{"operationId":"suppliers.download","tags":["附件"],"summary":"下载附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"文件下载","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/finance/attachments":{"post":{"operationId":"finance.upload","tags":["收支"],"summary":"上传附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/upload"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/finance/attachments/{attachmentId}":{"get":{"operationId":"finance.download","tags":["附件"],"summary":"下载附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"文件下载","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/community/attachments":{"post":{"operationId":"community.upload","tags":["交流"],"summary":"上传附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,80}$"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/upload"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/community/attachments/{attachmentId}":{"get":{"operationId":"community.download","tags":["附件"],"summary":"下载附件","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"attachmentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"文件下载","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/workspaces/{workspaceId}/projects":{"get":{"operationId":"projects.retired","tags":["项目"],"summary":"项目功能已下线，返回 410","security":[{"bearerAuth":[]}],"parameters":[{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object","required":["data","requestId"],"properties":{"requestId":{"type":"string"},"meta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"total":{"type":"integer"}}},"data":{"$ref":"#/components/schemas/write"}}}}}},"400":{"description":"参数或业务规则错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Key 无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"无权限或尚未开通","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"资源不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"幂等冲突或结果待核实","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"功能下线","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"文件超限","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"限流","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"内部错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"认证服务不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"ltak_…"}},"schemas":{"me":{"type":"object","properties":{"id":{"type":"string","description":"账号 ID"},"name":{"type":"string","description":"昵称"},"email":{"type":["string","null"],"description":"邮箱，可为空"}}},"spaces":{"type":"object","properties":{"id":{"type":"string","description":"空间 ID"},"name":{"type":"string","description":"空间名称"},"role":{"type":"string","description":"本人在空间内的角色"},"isOwner":{"type":"boolean","description":"是否为空间所有者"}}},"members":{"type":"object","properties":{"id":{"type":"string","description":"用户 ID"},"name":{"type":"string","description":"空间昵称"},"avatarUrl":{"type":["string","null"],"description":"头像地址，可为空"},"role":{"type":"string","description":"空间角色"}}},"tickets":{"type":"object","properties":{"id":{"type":"string","description":"工单 ID"},"content":{"type":"string","description":"需求原始内容"},"status":{"type":"string","description":"OPEN / IN_PROGRESS / DONE / CANCELLED"},"creatorId":{"type":"string","description":"创建者 ID"},"assigneeId":{"type":["string","null"],"description":"负责人 ID，可为空"},"createdAt":{"type":"string","description":"创建时间 ISO 8601","format":"date-time"},"updatedAt":{"type":"string","description":"更新时间 ISO 8601","format":"date-time"},"attachments":{"type":"array","items":{"type":"object"},"description":"原始内容附件，含 id、name、mimeType、size、downloadUrl"},"events":{"type":"array","items":{"type":"object"},"description":"仅详情：跟进与操作事件，含 id、kind、actorId、content、createdAt、attachments"}}},"customers":{"type":"object","properties":{"id":{"type":"string","description":"客户 ID"},"name":{"type":"string","description":"客户名称"},"phone":{"type":"string","description":"联系电话"},"notes":{"type":["string","null"],"description":"备注，可为空"},"managerId":{"type":["string","null"],"description":"客户经理 ID，可为空"},"createdById":{"type":"string","description":"创建者 ID"},"createdAt":{"type":"string","description":"创建时间 ISO 8601","format":"date-time"},"updatedAt":{"type":"string","description":"更新时间 ISO 8601","format":"date-time"},"companies":{"type":"array","items":{"type":"object"},"description":"仅详情：externalCompanyId、name、contactEmails、remark"}}},"suppliers":{"type":"object","properties":{"id":{"type":"string","description":"供应商 ID"},"name":{"type":"string","description":"供应商名称"},"taxId":{"type":["string","null"],"description":"税号，可为空"},"bankAccount":{"type":["string","null"],"description":"银行账号，可为空"},"bankName":{"type":["string","null"],"description":"银行名称，可为空"},"contactPerson":{"type":["string","null"],"description":"联系人，可为空"},"contactPhone":{"type":["string","null"],"description":"联系电话，可为空"},"address":{"type":["string","null"],"description":"地址，可为空"},"remark":{"type":["string","null"],"description":"备注，可为空"},"createdById":{"type":"string","description":"创建者 ID"},"createdAt":{"type":"string","description":"创建时间 ISO 8601","format":"date-time"},"updatedAt":{"type":"string","description":"更新时间 ISO 8601","format":"date-time"}}},"activities":{"type":"object","properties":{"id":{"type":"string","description":"跟进 ID"},"type":{"type":"string","description":"跟进类型"},"title":{"type":"string","description":"标题"},"content":{"type":["string","null"],"description":"内容，可为空"},"occurredAt":{"type":"string","description":"发生时间 ISO 8601","format":"date-time"},"createdById":{"type":"string","description":"记录者 ID"},"createdAt":{"type":"string","description":"创建时间 ISO 8601","format":"date-time"},"updatedAt":{"type":"string","description":"更新时间 ISO 8601","format":"date-time"},"attachmentKey":{"type":["string","null"],"description":"附件引用，可为空"},"attachmentName":{"type":["string","null"],"description":"附件名称，可为空"},"attachmentSize":{"type":["integer","null"],"description":"附件字节数，可为空"},"attachmentMimeType":{"type":["string","null"],"description":"附件 MIME，可为空"},"downloadUrl":{"type":"string","description":"有关联附件时返回的鉴权下载入口"}}},"finance":{"type":"object","properties":{"id":{"type":"string","description":"收支 ID"},"reimbursementNo":{"type":"string","description":"记录编号"},"reimbursementDate":{"type":"string","description":"发生日期 ISO 8601","format":"date-time"},"requesterId":{"type":"string","description":"记录归属人"},"createdById":{"type":"string","description":"创建者"},"description":{"type":"string","description":"说明"},"amount":{"type":"string","description":"十进制金额字符串","pattern":"^\\d+(\\.\\d{1,2})?$"},"recordType":{"type":"string","description":"INCOME / EXPENSE"},"fundAccount":{"type":"string","description":"资金账户"},"status":{"type":"string","description":"既有账务状态"},"reversedAt":{"type":["string","null"],"description":"原记录冲销时间，可为空","format":"date-time"},"reversedFromId":{"type":["string","null"],"description":"冲销来源 ID，可为空"},"supplierId":{"type":["string","null"],"description":"供应商 ID，可为空"},"attachmentKey":{"type":["string","null"],"description":"附件引用，可为空"},"attachmentName":{"type":["string","null"],"description":"附件名称，可为空"},"attachmentSize":{"type":["integer","null"],"description":"附件字节数，可为空"},"attachmentMimeType":{"type":["string","null"],"description":"附件 MIME，可为空"},"downloadUrl":{"type":"string","description":"有关联附件时返回的鉴权下载入口"},"createdAt":{"type":"string","description":"创建时间 ISO 8601","format":"date-time"},"updatedAt":{"type":"string","description":"更新时间 ISO 8601","format":"date-time"},"tags":{"type":"array","items":{"type":"object"},"description":"标签关联数组，元素为 { tag: { id, name, archivedAt } }"}}},"tags":{"type":"object","properties":{"id":{"type":"string","description":"标签 ID"},"name":{"type":"string","description":"标签名称"},"archivedAt":{"type":["string","null"],"description":"归档时间，可为空","format":"date-time"},"createdAt":{"type":"string","description":"创建时间 ISO 8601","format":"date-time"},"updatedAt":{"type":"string","description":"更新时间 ISO 8601","format":"date-time"}}},"community":{"type":"object","properties":{"id":{"type":"string","description":"交流 ID"},"categoryId":{"type":"string","description":"栏目 ID"},"authorId":{"type":"string","description":"作者 ID"},"parentId":{"type":["string","null"],"description":"回复目标 ID，可为空"},"content":{"type":"string","description":"交流内容"},"createdAt":{"type":"string","description":"创建时间 ISO 8601","format":"date-time"},"updatedAt":{"type":"string","description":"更新时间 ISO 8601","format":"date-time"},"media":{"type":"array","items":{"type":"object"},"description":"媒体数组，含 id、kind、mimeType、size、sortOrder、downloadUrl"},"reactions":{"type":"array","items":{"type":"object"},"description":"回应数组，含 userId、type"}}},"community.categories":{"type":"object","properties":{"id":{"type":"string","description":"栏目 ID"},"slug":{"type":"string","description":"栏目标识"},"name":{"type":"string","description":"栏目名称"},"description":{"type":["string","null"],"description":"栏目介绍，可为空"}}},"upload":{"type":"object","properties":{"id":{"type":"string","description":"附件 ID"},"objectKey":{"type":"string","description":"存储引用"},"name":{"type":"string","description":"文件名"},"mimeType":{"type":"string","description":"MIME 类型"},"size":{"type":"integer","description":"字节数"},"downloadUrl":{"type":"string","description":"需要 Bearer Key 的相对下载地址"},"attachmentKey":{"type":"string","description":"跟进或收支所用的附件引用"},"attachmentName":{"type":"string","description":"附件名称"},"attachmentSize":{"type":"string","description":"字节数字符串"},"attachmentMimeType":{"type":"string","description":"MIME 类型"},"media":{"type":"object","description":"仅交流上传：用于发布时关联的媒体对象"}}},"write":{"type":"object","properties":{"id":{"type":"string","description":"目标业务记录 ID（有对应记录时返回）"},"message":{"type":"string","description":"处理结果"},"tag":{"type":"object","description":"新增标签时返回 { id, name, archivedAt, createdAt, updatedAt }"}}},"Success":{"type":"object","required":["data","requestId"],"properties":{"data":{},"meta":{"type":"object"},"requestId":{"type":"string"}}},"Error":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}},"requestId":{"type":"string"}}}}}}