1. 接口描述
接口请求域名： mrs.tencentcloudapi.com 。
接口没有流量
将输入的图片类型报告结构化
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：ReportImageStructured。 |
| Version | 是 | String | 公共参数，本接口取值：2020-09-10。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| ImageURL | 否 | String | 医疗报告图片URL |
| ImageBase64 | 否 | String | 医疗报告图片base64编码后内容 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Report | ImageReport | 报告内容 注意：此字段可能返回 null，表示取不到有效值。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 图片报告结构化示例
输入检验报告图片，获取结构化结果
输入示例
POST / HTTP/1.1
Host: mrs.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ReportImageStructured
SecretId: AKID8B3nLiEulQtDNLwlBSZUIuLcjhT2fmro
Signature: dRTI5xyX7xZUTGmICKzR9fmraOA%3D
Nonce: 43231
Timestamp: 1602299565
Region: ap-guangzhou
Version: 2020-09-1
<公共请求参数>
{
"ImageURL": "http%3A%2F%2Fwenzhentest-1252949230.cos.ap-guangzhou.myqcloud.com%2Ffe489efe5d7ce4403bbd480ebf041e15",
"ImageBase64": ""
}输出示例
{
"Response": {
"RequestId": "4f656d4c-03a2-414a-bf1f-b273fbfaecc7",
"Report": {
"ImageText": {
"Confidence": 0,
"RotateAngle": 95,
"Text": ""
},
"KindSet": [
{
"Level": 1,
"ID": 11,
"Name": "检验报告"
},
{
"Level": 2,
"ID": 24,
"Name": "一般检验"
},
{
"Level": 3,
"ID": 316,
"Name": "血液一般检查"
}
],
"PersonalInfo": {
"Name": "",
"Gender": "",
"Age": "4岁",
"IDCard": "",
"HealthCardNum": "",
"SocialSecurityCardNum": "",
"Birthday": "",
"Ethnicity": "",
"Nationality": "",
"Married": "",
"Profession": "",
"EducationBackground": "",
"BirthPlace": "",
"MedicalInsuranceType": "",
"LinkPhone": "",
"LinkAddress": "",
"KinsfolkName": "",
"KinsfolkRelation": "",
"KinsfolkPhone": ""
},
"BasicInfo": {
"HospitalName": "",
"DepartmentName": "",
"ReportName": "",
"ReportTime": "",
"OutpatientNum": "",
"InHospitalNum": "",
"InspectionNum": "",
"ImageNum": "",
"RadiationNum": "",
"PathologyNum": "",
"BedNum": "",
"InHospitalTime": "",
"OutHospitalTime": "",
"CureDuration": "",
"HospitalizationTimes": "",
"InspectionTime": ""
},
"TestList": [
{
"ID": 0,
"Code": "",
"Name": "白细胞计数",
"Result": "9.53",
"Range": "4-10",
"Util": "10^9/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "中性粒细胞百分率",
"Result": "65.00",
"Range": "25-70",
"Util": "%",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "淋巴细胞百分率",
"Result": "25.70",
"Range": "20-65",
"Util": "%",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "单核细胞百分率",
"Result": "8.90",
"Range": "3-12",
"Util": "%",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "嗜酸性粒细胞百分率",
"Result": "0.10",
"Range": "0.4-8.0",
"Util": "%",
"IsNormal": false,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "嗜碱性粒细胞百分率",
"Result": "0.30",
"Range": "0-1",
"Util": "%",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "中性粒细胞计数",
"Result": "6.19",
"Range": "1.8-6.3",
"Util": "10^9/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "淋巴细胞计数",
"Result": "2.45",
"Range": "1.3-4.5",
"Util": "10^9/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "单核细胞计数",
"Result": "0.85",
"Range": "0.1-1.0",
"Util": "10^9/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "嗜酸细胞计数",
"Result": "0.01",
"Range": "0.02-0.52",
"Util": "10^9/L",
"IsNormal": false,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "嗜碱细胞计数",
"Result": "0.03",
"Range": "0-0.06",
"Util": "10^9/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "红细胞计数",
"Result": "4.68",
"Range": "3.75-5.5",
"Util": "10^12/l",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "血红蛋白",
"Result": "125",
"Range": "110-145",
"Util": "g/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "平均红细胞体积",
"Result": "82.30",
"Range": "76-90",
"Util": "fL",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "红细胞压积",
"Result": "38.50",
"Range": "31-50",
"Util": "%",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "平均血红蛋白含量",
"Result": "26.7",
"Range": "25.0-32.0",
"Util": "pg",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "平均血红蛋白浓度",
"Result": "324.0",
"Range": "320-370",
"Util": "g/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "RBC",
"Name": "体积分布宽度(CV)",
"Result": "39.30",
"Range": "37-54",
"Util": "fL",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "RBC",
"Name": "RBC体积分布宽度",
"Result": "13.5",
"Range": "11.6-16.5",
"Util": "%",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "血小板",
"Result": "255",
"Range": "125-350",
"Util": "10^9/L",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "血小板压积",
"Result": "0.20",
"Range": "0.09-0.30",
"Util": "%",
"IsNormal": false,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "大血小板比率",
"Result": "11.90",
"Range": "13-43",
"Util": "%",
"IsNormal": false,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "平均血小板体积",
"Result": "7.7",
"Range": "7.4-11.0",
"Util": "fL",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "血小板体积分布宽度",
"Result": "15.7",
"Range": "8.5-16.5",
"Util": "%",
"IsNormal": true,
"IsExceed": false
},
{
"ID": 0,
"Code": "",
"Name": "C-反应蛋白",
"Result": "2.35",
"Range": "0-5",
"Util": "mg/L",
"IsNormal": true,
"IsExceed": false
}
],
"Inspection": {
"Finding": {
"Text": "",
"TuberList": []
},
"Conclusion": {
"Text": "",
"SymptomList": []
}
},
"CaseHistory": {
"Treatment": {
"ChiefComplaint": "",
"AdmissionDiagnosis": ""
},
"HealthHistory": {
"DiseaseHistory": {
"Allergy": "",
"Disease": "",
"Infect": "",
"MainDisease": "",
"Operation": "",
"Transfusion": ""
},
"FamilyHistory": {
"RelativeMember": "",
"RelativeCancer": "",
"Genetic": ""
},
"MarryHistory": {
"Marriage": "",
"Fertility": ""
},
"PersonalHistory": {
"BirthPlace": "",
"Job": "",
"LivePlace": "",
"Personal": "",
"Smoke": "",
"Alcoholic": ""
},
"MenstrualHistory": {
"IsOrNot": "",
"MenarcheAge": "",
"LastTime": "",
"Flow": "",
"Cycles": "",
"Duration": ""
}
},
"CaseHistoryList": []
},
"Pathology": {
"PathologicalType": "",
"InfiltrationDepth": "",
"PTNM": "",
"DistanceMetastasis": "",
"SummaryText": "",
"DescText": "",
"HistologyType": "",
"HistologyLevel": "",
"SampleType": "",
"SamplePart": "",
"SampleSize": "",
"InvasiveList": [],
"MetastasisList": [],
"IHCList": []
}
}
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python
- Tencent Cloud SDK 3.0 for Java
- Tencent Cloud SDK 3.0 for PHP
- Tencent Cloud SDK 3.0 for Go
- Tencent Cloud SDK 3.0 for NodeJS
- Tencent Cloud SDK 3.0 for .NET
- Tencent Cloud SDK 3.0 for C++
- Tencent Cloud SDK 3.0 for Ruby
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.UnknownError | 未知错误。 |
| InvalidParameterValue.ImageCodeError | 图片base64编码错误。 |
| InvalidParameterValue.ImageIsNoText | 图片没有文字。 |
| InvalidParameterValue.ImageURLInvalid | 图片URL无效。 |
| InvalidParameterValue.TextIsNeed | 文本参数无效。 |
| LimitExceeded.ServerLimitExceeded | 服务流量超过限制。 |
| MissingParameter.ImageIsNeed | 缺少图片参数。 |
| OperationDenied.ImageTooLarge | 图片大小超过限制。 |
| OperationDenied.UnSupportThisType | 不支持的报告类型。 |
| RequestLimitExceeded.QPSLimitExceeded | 请求速度超过限制。 |
