检测报告检索
使用设备 App 登录用户账号和密码调用请求获取授权令牌,然后使用 获取数据查询access_token
获取到的授权令牌和待查询检测人手机号请求查询检测报告。
数据权限
接口数据权限按照授权令牌所属的系统角色进行数据隔离:
1、授权令牌不是企业管理员、分销商管理员、会员团队的队长时,接口返回“权限不足”。
2、授权令牌为企业管理员角色时,接口返回该企业下所有用户检测产生的报告。
3、授权令牌为分销商管理员角色时,接口返回分销商及下级分销商对应店铺的的用户检测报告
4、授权令牌为会员团队的队长角色时,接口返回该用户领导的团队及其所有下级团队中所有用户检测产生的报告。
请求
请求地址
https://yz365.tongueai.com/yz365-b2b2c/seller/tongue/check/record/query
请求方法
GET
请求头
accessToken: {access_token}
access_token
替换 获取数据查询access_token
获取到的授权令牌
请求参数
使用 URL search 传参
参数 | 描述 | 必填 | 备注 |
---|---|---|---|
phone | 检测人手机号 | 是 | |
checkCode | 体检码 | 是 | |
recordId | 检测记录ID(流水号) | 是 | |
start | 检测报告开始时间 | 否 | |
end | 检测报告结束时间 | 否 | |
size | 查询结果数量 | 否 | 范围为 1-10 ,默认为 1 |
注:
- 检测人手机号 phone、体检码 checkCode、检测记录ID(流水号)recordId 均未指定时,返回获取授权令牌使用的用户数据权限内的检测报告;
- 检测人手机号 phone、体检码 checkCode、检测记录ID(流水号)recordId 三个只需指定一个,此时其它参数均无效
- 开始时间
start
与结束时间end
需同时指定时才生效; - 开始时间与结束时间生效时,查询结果数量
size
无效; - 最大支持查询时长为30天;
- 时间支持一些常用格式,包括:
yyyy-MM-dd HH:mm:ss
yyyy/MM/dd HH:mm:ss
yyyy.MM.dd HH:mm:ss
yyyy年MM月dd日 HH时mm分ss秒
yyyy-MM-dd
yyyy/MM/dd
yyyy.MM.dd
yyyy-MM-dd HH:mm
yyyy-MM-dd HH:mm:ss.SSS
yyyyMMddHHmmss
yyyyMMddHHmmssSSS
yyyyMMdd
请求示例
Java OkHttp
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://yz365.tongueai.com/yz365-b2b2c/seller/tongue/check/record/query?phone=12312341234&size=2")
.method("GET", null)
.addHeader("accessToken", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpX2CJ9.eyJleHAiOjE2ODA3NzQwOTcsInVzZXJfbmFtZSI6Inh1d2VuYmluZyIsImp0a3I6ImZjMGFjYzhhLWIzZTctNGJjZi04YjQ3LTk2ZmFkYzAzZWM0NiIsImNsaWVudF4pZCI6ImNsb3VkYXBwIiwic2NvcGUiOlsiKiJdfQ.tES1Bw3Ivf4Q7dk7QLpJ28oFKyiLSLwEL8z6k3R7np1")
.build();
Response response = client.newCall(request).execute();
响应
响应示例
{
"success": true,
"message": "success",
"code": 200,
"timestamp": 1727233247994,
"result": [
{
"teamCode": "T-001",
"teamName": "测试团队",
"deviceCode": "YZ365-FD-24090077",
"deviceName": "wx",
"personName": "君迁子",
"personSex": 1,
"personAge": 22,
"personHeight": 0,
"personWeight": 0,
"checkTime": "2024-05-22 14:54:52",
"pdfUrl": "https://tongueaiyz365.oss-cn-qingdao.aliyuncs.com/ai/report/2024/09/52846063735b4f63a9bebd30436f78a7.pdf",
"healthIndex": 68.5,
"constitutionNames": "湿热血瘀",
"symptomName": "",
"tongueFeature": "正常人舌色,舌质淡红润泽。舌苔呈淡黄色或微黄色。",
"diseaseRisks": "精神压力,骨质疏松症,抑郁症,脑瘫,脂肪肝",
"diseaseRiskDetails": [
{
"diseaseName": "精神压力评估",
"riskIndex": 90.8,
"riskName": "预警",
"riskLevel": "高风险",
"tip": "尽量保持充分休息,可以通过深呼吸、肌肉渐进式放松训练等技巧,帮助身体和心理放松。适当运动,培养个人兴趣,根据实际情况选择缓解方法,必要时寻求帮助或接受专业心理疏导。"
},
{
"diseaseName": "心血管功能评估",
"riskIndex": 67.5,
"riskName": "中度风险",
"riskLevel": "中风险",
"tip": "选择低脂、低盐、低糖、高纤维的食物,如蔬菜、水果、谷类、鱼类等,戒烟和减少酒精摄入,控制体重,每周进行适当有氧运动。避免突然发生情绪过激的情况。建议定期进行心血管健康检查,如有心区不适疼痛甚至痛引肩背情况请立即就医。"
},
{
"diseaseName": "中风风险评估",
"riskIndex": 67.6,
"riskName": "中度风险",
"riskLevel": "中风险",
"tip": "注意饮食清淡,少食油脂类,戒烟限酒,保持健康体重水平。适量的运动可以降低中风的风险,生活中避免跌倒、大便干燥或情绪过激,如有口眼歪斜,肢体不协调或意识不清等情况请立即就医。"
},
{
"diseaseName": "骨质疏松症风险评估",
"riskIndex": 47.2,
"riskName": "轻度风险",
"riskLevel": "低风险",
"tip": "随着年龄增加,骨密度会逐渐降低,建议均衡饮食,补充营养,多摄入牛奶、鸡蛋、鱼虾等食物,进行适当的运动以维护骨骼生长和修复,避免吸烟和饮酒等不良生活习惯。"
},
{
"diseaseName": "肺结节风险评估",
"riskIndex": 28.9,
"riskName": "轻度风险",
"riskLevel": "低风险",
"tip": "尽量不吸烟,也避免二手烟及烟尘环境,健康饮食,定期锻炼。"
},
{
"diseaseName": "乳腺结节风险评估",
"riskIndex": 32.1,
"riskName": "轻度风险",
"riskLevel": "低风险",
"tip": "规律作息,避免熬夜,进行适量的运动,保持健康的体重,注意纾解压力,避免紧张、焦虑等情绪,定期进行乳房体检和乳腺癌的筛查。"
},
{
"diseaseName": "甲状腺结节风险评估",
"riskIndex": 53.9,
"riskName": "中度风险",
"riskLevel": "中风险",
"tip": "注意调节心情,保持规律作息和充足睡眠,进行适量的运动。注意饮食均衡,摄入足够的碘、维生素D等营养素,并控制体重、血糖、血脂。避免长期接触放射线或有害化学物质。定期体检,如触及颈部肿块,请及时就医。"
},
{
"diseaseName": "脂肪肝风险评估",
"riskIndex": 84.5,
"riskName": "预警",
"riskLevel": "高风险",
"tip": "注意控制热量的摄入和营养均衡。饮食宜清淡,补充多种维生素、富含多种动物蛋白、膳食纤维的食物,减少高脂、高糖、高盐饮食,忌辛辣、刺激性食物,忌暴饮暴食、禁烟酒,增强锻炼。定期体检,如果出现右上腹疼痛、皮肤不明原因黄疸、心绞痛等症状请及时就医。"
},
{
"diseaseName": "关节炎、颈椎或腰椎风险评估",
"riskIndex": 53.0,
"riskName": "轻度风险",
"riskLevel": "低风险",
"tip": "规律作息,适量运动,保持健康体重,均衡饮食,注意对关节部位的保护,夏天避免长时间吹空调或风扇。定期体检。"
},
{
"diseaseName": "肾功能风险评估",
"riskIndex": 45.2,
"riskName": "轻度风险",
"riskLevel": "低风险",
"tip": "建议您保证充足的休息,调整饮食,避免咸菜、火腿等高纳食物,适量饮水,避免一次性大量饮水,忌憋尿,每年定期检测肾功能,适当运动,放松心情,养成良好的生活习惯。"
}
],
"mainPerformance": [
"小腹胀痛,或腰、腹掣痛,或伴发热。",
"尿频尿急,尿道灼痛。",
"小便短黄,或浑浊,或尿血,或尿中见砂石。",
"食欲减退。",
"尿急。",
"经常腹痛欲泻。",
"经常咳黄色黏痰。",
"常常感到惊慌不安。",
"胁肋部胀痛。"
]
},
{
"teamCode": "T0000000",
"teamName": "张三团队",
"deviceCode": "YZ365-FD-44011077",
"deviceName": "zs",
"personName": "张三",
"personSex": 1,
"personAge": 22,
"personHeight": 0,
"personWeight": 0,
"checkTime": "2024-05-22 14:54:52",
"pdfUrl": "https://tongueaiyz365.oss-cn-qingdao.aliyuncs.com/ai/report/2024/09/52846063735b4f63a9bebd30436f78a7.pdf",
"healthIndex": 70.6,
"constitutionNames": "阴虚",
"symptomName": "心阴虚证,肺阴虚证,肝阴虚证,肝阳上亢证",
"tongueFeature": "正常人舌色,舌质淡红润泽。舌苔呈淡黄色或微黄色。",
"diseaseRisks": "精神压力,脑瘫,甲状腺结节",
"diseaseRiskDetails": [
...
],
"mainPerformance": [
"咳嗽反复发作,尤以晨起咳甚,咳声重浊。",
"痰多易咯,痰色白或带灰色,质地粘腻或稠厚成块。",
"胸闷气憋甚则闷痛,气喘甚则倚息不得平卧。",
"痰出则咳缓,憋闷疼痛减轻。",
"体倦,脘痞,腹胀,大便时溏。",
"食欲减退。",
"常常气喘。",
"常感情绪低落。"
]
}
]
}
结果格式
格式为 JSON
,响应数据位于 result
中
参数 | 类型 | 描述 |
---|---|---|
code | number | 200 为成功,其他为失败 |
success | boolean | 响应状态,success 为成功,其他为失败 |
message | string | 响应结果描述 |
timestamp | number | 时间戳 |
result | array | 响应数据 |
响应数据
result
中数组为响应的检测报告
参数 | 类型 | 描述 |
---|---|---|
teamCode | string | 检测使用设备登录用户所属会员团队编码 |
teamName | string | 检测使用设备登录用户所属会员团队名称 |
deviceCode | string | 检测使用的设备编码 |
deviceName | string | 检测使用的设备名称 |
personName | string | 检测人名称 |
personSex | number | 检测人性别(1 男,2 女) |
personAge | number | 检测人年龄 |
personPhone | string | 检测人手机号 |
personHeight | number | 检测人升高(单位cm ) |
personWeight | number | 检测人体重(单位kg ) |
checkTime | string | 检测时间 |
pdfUrl | string | 检测 PDF 报告 URL |
healthIndex | number | 健康指数,其值越大表示健康状态越好 |
constitutionNames | string | 体质 |
symptomName | string | 证型,进一步判断体质(constitutionNames )的结果,更为准确体现用户的真实体质 |
tongueFeature | string | 舌象特征分析 |
diseaseRisks | string | 风险疾病名称 |
diseaseRiskDetails | array | 风险疾病详情 |
mainPerformance | array | 主要表现 |
风险疾病详情
参数 | 类型 | 描述 |
---|---|---|
diseaseName | string | 疾病名称 |
riskIndex | number | 风险指数,其值越大表示风险越高 |
riskName | string | 风险名称 |
riskLevel | string | 风险等级 |
tip | string | 风险描述 |
接口变更说明
2025.09.05
响应结果新增diseaseRiskDetails
(风险疾病详情)字段。
2025.09.01
响应结果新增mainPerformance
(主要表现)字段。
2025.08.13
“舌象特征项”和“面象特征项”字段升级为“舌象特征分析”和“面象特征分析”文本字段。详情如下:
- 新增字段: tongueFeature(舌象特征分析)
- 移除字段: colorOfTongueNames、colorOfMossNames、mossNames、bodyfluidNames、shapeOfTongueNames、veinNames