1.舌诊测一测 - 流程

log-image

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"
}



By Macrocura, Copyright © 2020 all right reserved,powered by Gitbook            Last update: 2024-08-30 17:49:22