1.舌诊测一测 - 流程
2.舌诊测一测-创建会话
接口描述: 创建本次舌诊测一测的会话
综述: 上传舌面照片信息,系统会自动识别显示相应结果,同时根据舌头状况,系统还会提供简单选项,根据实际情况回答后即可继续解锁健康报告和调理方案
测试环境调用地址: https://qaapi.macrocura.com/open/api/diagnose/tongue/match/question/
预生产环境调用地址: https://prepapi.macrocura.com/open/api/diagnose/tongue/match/question/
生产环境调用地址: https://api.macrocura.com/open/api/diagnose/tongue/match/question/
请求方法: Post
请求参数格式: form-data
请求参数详情:
字段名 | 类型 | 是否必填 | 详细 |
---|---|---|---|
app_id | string | 是 | 应用id,对接外部应用的唯一id号 |
app_secret | string | 是 | 应用密钥,对接外部应用的秘钥,秘钥和id是一对一的关系 |
auth_code | string | 是 | 授权码,一个设备使用一个 |
source_code | int | 是 | 渠道编码,固定填0 |
feature_uuid | string | 否 | 特征 |
image | string/图片流 | 是 | 1.图片,image/url填其一,图像数据,支持url地址和图片文件两种方式,大小不超过10M。 2、图片最短边至少300px(其中舌部有效信息宽度至少100px,建议300px以上保证检测结果准确度)。 3、支持jpg/png/bmp/jpeg格式。 |
返回参数位置: HTTP Body
返回参数格式: JSON
返回参数详情:
字段名 | 类型 | 详细描述 |
---|---|---|
code | int | 返回业务状态码 |
success | bool | 请求是否成功 |
msg | string | 失败或者成功信息 |
data | object | 返回的数据 |
data:
字段名 | 类型 | 详细描述 |
---|---|---|
session_id | string | 会话id |
log_id | string | 日志id |
basic_questions | array | 基本问题 |
addition_questions | array | 额外的病史问题 |
basic_questions:
字段名 | 类型 | 详细描述 |
---|---|---|
id | int | 问题序号 |
title | string | 问题题目 |
options | array | 问题选项 |
options:
字段名 | 类型 | 详细描述 |
---|---|---|
name | string | 选项的名称 |
value | string | 选项对应的值 |
addition_questions:
字段名 | 类型 | 详细描述 |
---|---|---|
id | int | 问题序号 |
title | string | 问题题目 |
options | array | 问题选项 |
options:
字段名 | 类型 | 详细描述 |
---|---|---|
name | string | 选项的名称 |
value | string | 选项对应的值 |
返回错误码的含义:
错误码 | 错误信息 |
---|---|
10000 | 服务器内部错误,请再次请求 |
10001 | 必填字段未填写: *字段 |
10002 | 字段类型错误: *字段 |
10003 | 字段长度错误: *字段 |
10004 | 字段范围错误: *字段 |
10005 | 字段枚举错误: *字段 |
10006 | 身份证认证不通过 |
10007 | 图片边长不符合要求 |
10008 | 读取图片文件错误 |
10009 | 不支持的图片格式,请进行转码或更换图片 |
10010 | 图片为空,请检查后重新尝试 |
10011 | 图片大小超限制 |
20010 | 未检测到图片中舌部或面部区域 |
20020 | 图片过于模糊,请更换图片 |
20030 | 图片亮度异常,请更换图片 |
20040 | 图片边长不符合要求 |
20050 | 未识别出舌部特征 |
20060 | 此会话session id不存在 |
10500 | 目标识别舌部或面部区域失败 |
10100 | 图片上传阿里云storage失败 |
10200 | 舌面诊断规则匹配失败 |
10300 | 诊断推荐问题失败 |
10400 | 诊断推荐报告失败 |
返回成功参数示例:
{
"code": 20000,
"success": true,
"msg": "成功",
"data": {
"basic_questions": [
{
"id": 5,
"title": "性别",
"options": [
{
"name": "男性",
"value": "2ca801d5-108e-4354-af86-622736ea157e"
},
{
"name": "女性",
"value": "746a4a8c-daad-4799-bf7a-aae33d8801a2"
}
]
},
{
"id": 22,
"title": "年龄",
"options": [
{
"name": "2-12岁",
"value": "09167e22-be6d-4681-9afd-72cd6ebc7c9b"
},
{
"name": "12-44岁",
"value": null
},
{
"name": "45岁以上",
"value": "71c415f1-1a37-4edf-9f8e-79cc848367af"
}
]
}
],
"addition_questions": [
{
"id": 339,
"title": "当前无明显不适,仅检查体质。",
"options": [
{
"name": "是",
"value": "1"
},
{
"name": "否",
"value": "0"
}
]
}
],
"session_id": "4a9f16e4-9a77-11ee-a379-00163e30cbb5",
"log_id": "f9445fa1-234c-4006-93ba-ab1b70c490e1"
},
"reason": null
}
3.舌诊测一测-获取报告
接口描述: 回答问题,获取报告,一般需要多次回答才出报告
测试环境调用地址: https://qaapi.macrocura.com/open/api/diagnose/tongue/inquiry/report/
预生产环境调用地址: https://prepapi.macrocura.com/open/api/diagnose/tongue/inquiry/report/
生产环境调用地址: https://api.macrocura.com/open/api/diagnose/tongue/inquiry/report/
请求方法: Post
请求参数格式: json
请求参数详情:
字段名 | 类型 | 是否必填 | 详细描述 |
---|---|---|---|
app_id | string | 是 | 应用id,对接外部应用的唯一id号 |
app_secret | string | 是 | 应用密钥,对接外部应用的秘钥,秘钥和id是一对一的关系 |
auth_code | string | 是 | 授权码,一个设备使用一个 |
session_id | string | 是 | 会话id |
basic_answers | array | 是 | 基本问题答案 |
addition_answers | array | 是 | 额外的病史问题答案 |
basic_answers:
字段名 | 类型 | 是否必填 | 详细描述 |
---|---|---|---|
id | int | 是 | 问题序号 |
answer | string | 是 | 题目答案对应的值 |
addition_answers:
字段名 | 类型 | 是否必填 | 详细描述 |
---|---|---|---|
id | int | 是 | 问题序号 |
answer | string | 是 | 题目答案对应的值 |
{
"app_id": "304162e77d00abda2e061",
"app_secret": "a23310942b414a49281b4978",
"auth_code": "51a06305c41c4dfe37c6ad73",
"session_id": "163ca048-5fba-11ef-9d10-00163e30cbb5",
"basic_answers": [
{
"id": 5,
"answer": "2ca801d5-108e-4354-af86-622736ea157e"
},
{
"id": 22,
"answer": "09167e22-be6d-4681-9afd-72cd6ebc7c9b"
}
],
"addition_answers": [
{
"id": 343,
"answer": "1"
}
]
}
注意事项: 针对以上的问题回答,要与提问的顺序保持一致。比如先提问的 "id": 322,再提问的 "id": 323,那么在回答323的时候,应该按照[322, 323]的顺序回答
返回参数位置: HTTP Body
返回参数格式: JSON
返回参数详情:
字段名 | 类型 | 详细描述 |
---|---|---|
code | int | 返回业务状态码 |
success | bool | 请求是否成功 |
msg | string | 失败或者成功信息 |
data | object | 返回的数据 |
data:
字段名 | 类型 | 详细描述 |
---|---|---|
session_id | string | 会话id |
log_id | string | 日志id |
answer_type | int | 答案的类型,1,返回后续问题 2,返回报告 3,信息不足,无法出具报告 |
report | object | 报告数据 |
addition_questions | array | 额外的病史问题 |
report:
字段名 | 类型 | 详细描述 |
---|---|---|
syndrome_name | string | 病机名称 |
syndrome_explain | string | 病机解释 |
syndrome_point | string | 辨证要点(客户定制字段,其他场景返回null) |
contraindication | string | 禁忌症状(客户定制字段,其他场景返回null) |
diagnose_key_words | string | 诊断所有关键词 |
diagnose_explain | string | 诊断的详解 |
symptom_names | array(object) | 特征 |
tf_detect_matches | array(object) | 舌部照片的特征坐标 |
commodity | array | 商品信息 |
combine_prescriptions | array | 组合推方信息(客户定制字段,其他场景返回null) |
risk_warning | string | 风险预警 |
suggest_live | string | 健康生活建议 |
suggest_food | string | 饮食调养建议 |
symptom_names:
字段名 | 类型 | 详细描述 |
---|---|---|
name | string | 特征名 |
desc | string | 文案 |
type | string | 特征分类 |
舌部照片的特征坐标:
字段名 | 类型 | 详细描述 |
---|---|---|
url | string | 图片地址 |
detect_boxes | array(object) | 具体的特征坐标位置 |
具体的特征坐标位置:
字段名 | 类型 | 详细描述 |
---|---|---|
left_x | int | x轴左坐标 |
left_y | int | y轴下坐标 |
right_x | int | x轴右坐标 |
right_y | int | y轴上坐标 |
name | string | 名称 |
commodity:
字段名 | 类型 | 详细描述 |
---|---|---|
commodity_name | string | 商品名称 |
commodity_img_path | string | 商品图片 |
commodity_shopping_link | string | 商品链接 |
combine_prescriptions:
字段名 | 类型 | 详细描述 |
---|---|---|
title | string | 组合荐方名称 |
pharmacy_tcm | string | 药店品类 |
presc_name | string | 方剂名称 |
tcm_details | string | 方剂组成 |
usage | string | 用量 |
medical_advice | string | 医嘱 |
presc_background | string | 方剂背景 |
addition_questions:
字段名 | 类型 | 详细描述 |
---|---|---|
id | int | 问题序号 |
title | string | 问题题目 |
options | array | 问题选项 |
options:
字段名 | 类型 | 详细描述 |
---|---|---|
name | string | 选项的名称 |
value | string | 选项对应的值 |
返回参数示例:
{
"code": 20000,
"success": true,
"msg": "成功",
"data": {
"answer_type": 2,
"report": {
"syndrome_name": "平和体质",
"syndrome_explain": "舌象无明显异常。",
"syndrome_point": null,
"contraindication": null,
"diagnose_key_words": [
"身体素质好",
"抵抗力强",
"恢复能力强",
"形体匀称",
"面色红润",
"精力充沛",
"疲劳耐受度高",
"对环境适应能力强",
"胃口好",
"睡眠好"
],
"diagnose_explain": "先天体质好,后天养护好,身体状态良好且稳定;\n性格随和开朗。",
"commodity": [
{
"commodity_name": "国药集团旗下一方四季 黑枸杞植物饮品盒装 30ml*7条 可以喝的原花青素",
"commodity_img_path": "http://mddfiles.oss-cn-shanghai.aliyuncs.com/mdd-back-all/.upload/2023-04-14/%E4%B8%80%E6%96%B9%E9%BB%91%E6%9E%B8%E6%9D%9E%E6%A4%8D%E7%89%A9%E9%A5%AE%E5%93%81-%E4%B8%BB%E5%9B%BE230419.jpg",
"commodity_shopping_link": "packages/goods/detail/index?alias=36884garnom1t2c&shopAutoEnter=1"
},
{
"commodity_name": "百年同康 辽宁沈阳蛹虫草150g 色泽金黄粉多饱满",
"commodity_img_path": "http://mddfiles.oss-cn-shanghai.aliyuncs.com/mdd-back-all/.upload/2023-04-14/%E7%99%BE%E5%B9%B4%E5%90%8C%E5%BA%B7%E8%9B%B9%E8%99%AB%E8%8D%89-%E4%B8%BB%E5%9B%BE-230419.jpg",
"commodity_shopping_link": "packages/goods/detail/index?alias=2ojc2q29zc4cxd4&shopAutoEnter=1"
}
],
"combine_prescriptions": [],
"risk_warning": "一般所处于身体健康状态,无明显疾病表现。",
"suggest_live": null,
"suggest_food": "平和质宜寒温适中,不宜过于偏食寒性或热性的食物,可根据不同季节气候特点,进行饮食调养。春宜升补,多食蔬菜,如菠菜、芹菜、春笋、荠菜等轻灵宣透、清温平淡之品。夏宜清补,应选用清热解暑、清淡芳香之品,多食西瓜、番茄、菠萝等,酌情食用金银花、菊花、芦根、绿豆、冬瓜、苦瓜、黄瓜、生菜等,以清热除暑。秋季宜食用濡润滋阴之品,如沙参、麦冬、阿胶、甘草等。冬季宜温补,可选用姜、胡椒、羊肉、牛肉、狗肉等温热助阳之品。",
"symptom_names": [
{
"name": "舌质齿痕",
"desc": "舌边被牙齿挤压产生的痕迹,正常人也有出现;多见于脾虚、气虚、湿气较重的群体。",
"type": "舌形"
},
{
"name": "舌色红",
"desc": "舌色较正常舌象偏红,或舌色鲜红;多因舌体肌肉组织充血导致,说明体内有热邪,舌色越红热越重;生理状态下也可以见于月经期女性。",
"type": "舌色"
},
{
"name": "舌苔白",
"desc": "苔色白;也就是舌头表面的角化层呈乳白色;可见于正常人群,也可见于体内有寒邪或者早期呼吸道感染等症状。",
"type": "苔色"
},
{
"name": "舌苔润",
"desc": "舌苔干湿适中,不滑不燥。多见于正常人,身体较健康,无明显病灶;若在生病过程中,则提示人体缺水不明显。",
"type": "苔质"
}
],
"tf_detect_matches": {
"detect_boxes": [
{
"left_x": 951,
"left_y": 551,
"right_x": 1052,
"right_y": 745,
"name": "舌部齿痕"
},
{
"left_x": 840,
"left_y": 787,
"right_x": 943,
"right_y": 940,
"name": "舌部齿痕"
}
],
"url": "https://mddfiles.oss-cn-shanghai.aliyuncs.com/mdd-back-all/.upload/2024/08/21/07b7e24f-47af-417b-93bc-d8e29de8cbec.jpeg"
}
},
"addition_questions": [],
"session_id": "163ca048-5fba-11ef-9d10-00163e30cbb5"
},
"reason": null,
"log_id": "f0f96e72ff1e4e02a1727303c988182f"
}