> ## Documentation Index > Fetch the complete documentation index at: https://docs-claimagent.textin.com/llms.txt > Use this file to discover all available pages before exploring further. # ICD 疾病编码查询 > ICD 疾病编码查询 按疾病名称或编码搜索 ICD-10 疾病分类信息 ## OpenAPI ````yaml POST /doc-agent/api/v1/capability/icd/search openapi: 3.0.3 info: description: |- CapabilityService 独立子能力服务 提供文件上传、图像质检、材料分类、材料抽取等独立能力，不依赖案件流程。 通过 batch_id 和 material_id 串联各能力调用。 ## 典型调用流程 1. 上传文件 → UploadFiles，获得 batch_id 和 material_id 列表 2. (可选)图像质检 → CheckImageQuality，可独立调用，也可用上传返回的 material_id 3. (可选)材料分类 → ClassifyMaterial，可独立调用，也可用上传返回的 material_id 4. 材料抽取 → ExtractMaterial，传入 material_id 列表，返回每个材料的状态和结果 5. 轮询 → 重复调用 ExtractMaterial 直到所有材料完成，或等待 callback_url 回调 注: 质检和分类可独立调用，不依赖抽取流程；抽取接口的 material_ids 必须来自上传接口。 注: ExtractMaterial 幂等，已完成的材料不会重新抽取，失败的材料会自动重试。 ## 错误响应 所有接口错误均返回 HTTP 非 200 状态码，body 格式: {"code": 400, "msg": "错误描述"} 常见错误码: 400 — 参数校验失败(缺少必填字段、文件数超限等) 403 — 认证失败(x-ti-app-id 或 x-ti-secret-code 缺失/无效) 404 — 资源不存在(material_id / batch_id 无效) 500 — 内部处理异常 错误响应示例: {"code": 404, "msg": "material not found"} {"code": 404, "msg": "batch not found"} {"code": 400, "msg": "material_ids or batch_id is required"} {"code": 400, "msg": "material does not belong to the specified batch"} {"code": 400, "msg": "files or file_urls is required"} {"code": 400, "msg": "所有材料必须属于同一批次"} {"code": 403, "msg": "x-api-key 或 x-ti-app-id/x-ti-secret-code 不能为空"} title: CapabilityService API version: 0.0.1 servers: - url: https://agents.textin.com/ security: [] tags: - name: CapabilityService paths: /doc-agent/api/v1/capability/icd/search: post: tags: - CapabilityService description: |- ICD 疾病编码查询 按疾病名称或编码搜索 ICD-10 疾病分类信息 operationId: CapabilityService_SearchICD parameters: - in: header name: x-ti-app-id required: true schema: type: string - in: header name: x-ti-secret-code required: true schema: type: string requestBody: content: application/json: example: disease_str: S52.400 page_num: 1 page_size: 10 schema: $ref: '#/components/schemas/capability.v1.CapabilityICDRequest' required: true responses: '200': content: application/json: example: code: 200 data: list: - category_name: ICD-10疾病编码 category_uuid: be966ca476acbba3623214e560cd2e6b detail_uuid: 926d1709cb6f0d4a32a7b96526f6d136 disease_code: S52.400 disease_name: 尺骨和桡骨骨干均骨折 id: 40749 is_show: true parent_uuid: a6f60a6458e81f5f8da6ca1507bbccd5 pagination: page: 1 page_size: 10 sum: 1 message: OK schema: properties: code: description: 业务状态码 example: 200 type: integer data: $ref: '#/components/schemas/capability.v1.CapabilityICDResponse' message: description: 状态说明 example: OK type: string type: object description: OK components: schemas: capability.v1.CapabilityICDRequest: properties: disease_str: description: 疾病名称或编码(如 "S52.400" 或 "骨折") type: string page_num: description: 页码(从 1 开始，默认 1) format: int32 type: integer page_size: description: 每页数量(默认 10) format: int32 type: integer type: object capability.v1.CapabilityICDResponse: properties: list: description: ICD 疾病编码列表 items: $ref: '#/components/schemas/capability.v1.ICDItem' type: array pagination: allOf: - $ref: '#/components/schemas/common.Pagination' description: 分页信息 type: object capability.v1.ICDItem: description: ICD 疾病编码信息 properties: additional_code: description: 附加编码 type: string category_name: description: 分类名称(如 "ICD-10疾病编码") type: string category_uuid: description: 分类唯一标识 type: string detail_uuid: description: 明细唯一标识 type: string disease_code: description: 疾病编码 type: string disease_name: description: 疾病名称 type: string id: description: 记录 ID format: int32 type: integer is_show: description: 是否展示 type: boolean memo: description: 备注 type: string parent_uuid: description: 父级唯一标识 type: string type: object common.Pagination: properties: page: description: 当前页码（从1开始） format: int32 type: integer page_size: description: 每页数量 format: int32 type: integer sum: description: 总记录数 format: int32 type: integer type: object ````