检测报告回调
检测报告回调接口需要与商务员联系申请开通。
开通接口前需要现根据提供客户侧回调接口地址。
开通成功后,云诊365会提供接口相应秘钥。
回调逻辑说明
1.企业会员每一次成功检测都会触发一次回调。
2.云诊平台向客户方提供的回调接口地址中POST数据,客户侧系统成功接收到回调后,应响应 sussess 字符串。
3.对于未正确响应或回调接口地址请求失败的,云诊每间隔三分钟,再次回调,累计最多回调五次,不再执行回调。 4.客户侧回调接收接口响应时间不得超过3秒,超时直接断连,视为回调失败,进入重试逻辑。
回调
回调地址
需由客户侧系统提供。
回调请求方法
POST
回调参数
- 使用
form-data方式传参。
| 参数 | 描述 | 必传 | 备注 |
|---|---|---|---|
encryptedJson | 健康检测数据 | 是 | 健康检测数据以加密方式传递,接收数据后应使用 AES 秘钥进行解密。秘钥在开通接口后由云诊提供 |
timestamp | 回调时间戳 | 是 |
回调接收处理示例
- 接收到通知后,客户系统处理流程参考如下代码:
@PostMapping("yunzhenCallback")
public String yunzhenCallback(String encryptedJson, String timestamp) throws Exception {
// AES秘钥
String aesKey = "";
// 1. 先解密
String source = AesSimpleUtil.decrypt(encryptedJson, aesKey);
JSONObject jsonObject = JSONObject.parseObject(source);
// 2. 做自有业务处理
// 3. 返回success字符串
return "success";
}
encryptedJson原文
原文示例
{
"teamCode": "T-001",
"teamName": "测试团队",
"deviceCode": "YZ365-FD-24090077",
"deviceName": "wx",
"memberPhone": "18856789000",
"personName": "君迁子",
"personSex": 1,
"personAge": 22,
"personHeight": 0,
"personWeight": 0,
"personPhone": "18856789011",
"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": "",
"maiSum": " 细,软,数",
"leftMaiSum": "数",
"rightMaiSum": "细,软,数",
"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": [
"小腹胀痛,或腰、腹掣痛,或伴发热。",
"尿频尿急,尿道灼痛。",
"小便短黄,或浑浊,或尿血,或尿中见砂石。",
"食欲减退。",
"尿急。",
"经常腹痛欲泻。",
"经常咳黄色黏痰。",
"常常感到惊慌不安。",
"胁肋部胀痛。"
],
"occurrenceMechanism": "多因外伤、情志不畅等导致血液运行不畅;情志过激化火、外感热邪、喜食辛辣等导致体内有热,形成瘀热互结。",
"meridianRiskS": [
{
"riskName": "足厥阴肝经(偏实)",
"riskImg": "https://labelsys-images.oss-cn-hangzhou.aliyuncs.com/healthcare/中医经络/足厥阴肝经循行图.jpg",
"riskIntro": "肝经偏盛病理表现通常为气逆、气滞、血瘀等。常见症状有急躁易怒、情志抑郁、善太息、头目胀痛、胁痛、胁下积块、少腹痛、口苦口干、疝气、遗尿、小便不利、月经不调、下肢痹痛等症。本经腧穴主治肝胆病症、泌尿生殖、神经、眼科疾病和本经经脉所过部位的疾病。常用穴位:按揉或针刺期门穴、章门穴、太冲穴等。",
"riskIndex": 57.5
},
{
"riskName": "足太阳膀胱经(偏实)",
"riskImg": "https://labelsys-images.oss-cn-hangzhou.aliyuncs.com/healthcare/中医经络/足太阳膀胱经循行图.jpg",
"riskIntro": "膀胱经偏盛,可导致泌尿生殖、神志、呼吸、循环、消化系统疾病及热性病、脏腑病、头面病、筋病、痔疾、膀胱病等。常见症状有:尿频尿急、尿道灼痛、小便短黄、尿浊、尿血、小腹胀痛、后背或下肢酸痛、额头或后头疼痛等症状。常用的经络穴位调理有循背部及下肢膀胱经拔罐、刮痧;用推、捻、提、放等手法进行捏脊;按揉委中、承山、合阳、睛明、攒竹等穴。",
"riskIndex": 56.0
},
{
"riskName": "手少阴心经(偏实)",
"riskImg": "https://labelsys-images.oss-cn-hangzhou.aliyuncs.com/healthcare/中医经络/手少阴心经循行图.jpg",
"riskIntro": "心主神明、主血脉。心经偏盛可导致心、胸、神志方面的异常,常见症状有:心烦、心胸憋闷作痛、肩与內臂疼痛、口干、失眠、头痛、健忘、神志失常、便秘、尿黄等症状。本经主治心、胸、神志病以及经脉循行部位的其他病证。常用穴位:循经拍打上肢内侧后缘及胸部;从极泉至少冲穴顺经刮痧;按揉少府、极泉穴;点刺少冲穴等。",
"riskIndex": 16.0
},
{
"riskName": "足少阴肾经(偏实)",
"riskImg": "https://labelsys-images.oss-cn-hangzhou.aliyuncs.com/healthcare/中医经络/足少阴肾经循行图.jpg",
"riskIntro": "肾失衡以虚证为多,所谓实证,也多属本虚标实,当辨证施治。肾经异常,常见症状有:腰膝酸软、眩晕、耳鸣、骨质疏松、齿松发枯、小便涩痛或灼痛、小腹刺痛、女性月经不调、失眠多梦、五心烦热、口燥咽干等症状。本经主治泌尿生殖系统、神经、精神、呼吸、消化和循环系统某些病症,以及本经脉所经过部位的病症。常用穴位:涌泉、太溪、照海、复溜、阴谷等。",
"riskIndex": 11.0
},
{
"riskName": "足少阳胆经(偏实)",
"riskImg": "https://labelsys-images.oss-cn-hangzhou.aliyuncs.com/healthcare/中医经络/足少阳胆经循行图.jpg",
"riskIntro": "胆与肝相表里,胆经偏盛,常见症状有:口苦口干、胸胁苦满、咽部不适、头痛、善太息,疟疾,易怒,惊悸,失眠等症状。本经主治肝胆病,侧头、目、耳、咽喉病,神志病,热病及经脉循行部位的其他病证。常用穴位:拍打头部侧面、腋下、下肢外侧中线疏通胆经气机;循经推瞳子髎穴至足窍阴穴;按揉或针刺瞳子髎、上关、悬颅、阳白、头临泣、风池等。",
"riskIndex": 9.0
}
]
}
字段说明
| 参数 | 类型 | 描述 |
|---|---|---|
teamCode | string | 检测使用设备登录用户所属会员团队编码 |
teamName | string | 检测使用设备登录用户所属会员团队名称 |
deviceCode | string | 检测使用的设备编码 |
deviceName | string | 检测使用的设备名称 |
memberPhone | 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 | 主要表现 |
occurrenceMechanism | string | 发生机制 |
meridianRiskS | array | 异常经络 |
maiSum | string | 双手总脉 |
leftMaiSum | string | 左手脉象 |
rightMaiSum | string | 右手脉象 |
风险疾病详情
| 参数 | 类型 | 描述 |
|---|---|---|
diseaseName | string | 疾病名称 |
riskIndex | number | 风险指数,其值越大表示风险越高 |
riskName | string | 风险名称 |
riskLevel | string | 风险等级 |
tip | string | 风险描述 |
异常经络详情
| 参数 | 类型 | 描述 |
|---|---|---|
riskName | string | 经络名称 |
riskImg | string | 经络图标 |
riskIntro | string | 说明 |
riskIndex | number | 风险指数,其值越大表示风险越高 |
接口变更说明
2025.10.28
检测报告回调接口正式上线。
2025.11.25
接口新增”双手总脉“、”左手脉象“、”右手脉象“字段,用于返回脉诊结果;新增“会员手机号”字段。
- 新增字段: maiSum、leftMaiSum、rightMaiSum
- 新增字段: memberPhone
