> ## 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. # 医疗机构查询 > 医疗机构查询 按名称模糊搜索医疗机构信息，包含医院等级、地址、联系方式等 ## OpenAPI ````yaml POST /doc-agent/api/v1/capability/medical-institution/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/medical-institution/search: post: tags: - CapabilityService description: |- 医疗机构查询 按名称模糊搜索医疗机构信息，包含医院等级、地址、联系方式等 operationId: CapabilityService_SearchMedicalInstitution 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: institution_name: 北京协和 page_num: 1 page_size: 10 schema: $ref: >- #/components/schemas/capability.v1.CapabilityMedicalInstitutionRequest required: true responses: '200': content: application/json: example: code: 200 data: list: - address: 西城区大木仓胡同41号 hospital_grade: '1' hospital_level: '3' id: '238614' institution_code: YLJG138204 institution_name: 北京协和医院(西单院区) institution_name_alias: 北京邮电总医院北京协和医院西院、中国医学科学院北京协和医院西院 institution_nature: '1' institution_type: '1' institution_uuid: 80ee544cb80b11e9b11b88e9fe8153df medical_nature: '1' zone_city: 北京市 zone_city_code: '110100' zone_county: 西城区 zone_county_code: '110102' zone_province: 北京 zone_province_code: '110000' - address: 东城区帅府园一号 hospital_grade: '1' hospital_level: '3' id: '332500' institution_code: YLJG213038 institution_name: 北京协和医院(东单院区) institution_nature: '1' institution_type: '1' institution_uuid: 4274236c65e741fca681a317b6e6b551 medical_nature: '1' zone_city: 北京市 zone_city_code: '110100' zone_county: 东城区 zone_county_code: '110101' zone_province: 北京市 zone_province_code: '110000' pagination: page: 1 page_size: 10 sum: 7 message: OK schema: properties: code: description: 业务状态码 example: 200 type: integer data: $ref: >- #/components/schemas/capability.v1.CapabilityMedicalInstitutionResponse message: description: 状态说明 example: OK type: string type: object description: OK components: schemas: capability.v1.CapabilityMedicalInstitutionRequest: properties: institution_name: description: 医疗机构名称 type: string page_num: description: 页码(从 1 开始，默认 1) format: int32 type: integer page_size: description: 每页数量(默认 10) format: int32 type: integer type: object capability.v1.CapabilityMedicalInstitutionResponse: properties: list: description: 医疗机构列表 items: $ref: '#/components/schemas/capability.v1.MedicalInstitutionItem' type: array pagination: allOf: - $ref: '#/components/schemas/common.Pagination' description: 分页信息 type: object capability.v1.MedicalInstitutionItem: description: 医疗机构信息 properties: address: description: 详细地址 type: string contact: description: 联系人 type: string contact_phone: description: 联系电话 type: string email: description: 邮箱 type: string hospital_grade: description: 医院级别 type: string hospital_level: description: 医院等级 type: string id: description: 记录 ID type: string institution_code: description: 机构编码 type: string institution_introduce: description: 机构简介 type: string institution_name: description: 机构名称 type: string institution_name_alias: description: 机构别名 type: string institution_nature: description: 机构性质 type: string institution_type: description: 机构类型 type: string institution_url: description: 机构网址 type: string institution_uuid: description: 机构唯一标识 type: string medical_nature: description: 医疗性质 type: string zip_code: description: 邮编 type: string zone_city: description: 城市名称 type: string zone_city_code: description: 城市编码 type: string zone_county: description: 区县名称 type: string zone_county_code: description: 区县编码 type: string zone_province: description: 省份名称 type: string zone_province_code: 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 ````