Skip to content
On this page

本文档主要针对 API 开发者,描述疾病识别开放平台接口服务的相关技术内容。

接口能力

接口名称接口能力简要描述
项目列表接口提供指定场景的项目列表
报告单识别接口对血常规、生化等报告单的识别接口,返回标准化数据解析结果
疾病识别接口根据报告单项目结果数据进行指定的疾病概率识别,返回疾病风险概率
结果分析接口对疾病预测数据的图形化展示
疾病科普接口提供相关疾病的科普知识
疾病问卷接口提供相关疾病的流调问卷内容
提交问卷接口根据所提交问卷信息提供疾病综合评估

公共信息定义

  • 公共请求头
名称类型描述
Authorizationstring用于验证请求合法性的认证信息
Versionstring接口版本号
Timestampstring时间戳(ms),如果请求中的时间和服务器当前时间差 15 分钟以上,服务器将拒绝该请求。
  • 公共响应体
名称类型描述
requestIdstring此次请求的请求 id
codeint响应码
msgstring响应码含义
dataobject响应内容
timeint接口响应时间,单位 ms

访问控制

  • 在 Header 中包含签名

    您可以在 HTTP 请求的 Header中增加Authorization 来包含签名(Signature)信息,表明该消息已被授权。

Authorization 字段计算的方法

txt
Authorization = App_key + ":" + Signature
Signature = md5(Version + Timestamp + App_secret)

参数说明

参数类型是否必选示例值说明
AppKeystringG7q29A93****密钥中的 AppKey
AppSecretstringGUpzG2tc****密钥中的 AppSecret
Versionstringv1请求接口的版本号
Timestampstring1649297700000时间戳(ms),如果请求中的时间和服务器当前时间差 15 分钟以上,服务器将拒绝该请求。

签名示例

假设 App_key 为LTAI4FixJv,App_secret 为Q0YehC6ZyugWfjo,Timestamp 为1649297700000

Signature = md5(v11649297700000Q0YehC6ZyugWfjo)=145C6FE02731AFA5DC5CCCECF47C8CEA Authorization = LTAI4FixJv:145C6FE02731AFA5DC5CCCECF47C8CEA

  • Signature 为 32 位大写字符串

错误码

错误码含义备注
401授权类错误检查授权信息,如签名等
1系统类错误重新发起请求
3 开头业务类错误根据错误提示进行排查