API文档中心
隐私通话API
身份验证API
自然语言API
短信语音API
游戏赛事API
数据服务API
异步通知API
安全工具API
图像/人像处理
商户订单API
其他鉴权API
会员工具API
中医Ai智慧API
业务充值API
SDK与工具下载
中医智慧面诊
接口调用费用：3元/次，费用将在请求返回成功后扣取。
本接口实时返回数据，提交后请立即保存数据或查询订单再次获取结果。请确保账户余额≥100元，否则无法调用。
请求地址
| 请求环境 | 接口地址 |
|---|---|
| ALL | /Tcmsai/faceAnalysis.api |
请求参数（GET/POST）
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| appid | String | 是 | 32 | 开放平台的APPID | 14000000000000 |
| access_token | String | 是 | 600 | 通过access_token接口获取到的开放平台ac | ZLGJSCXXXXXXXXXXXXXXXXXX |
| orderid | String | 是 | 32 | 订单号，后续通过单号可查询结果，如 isReq 为2，请勿更改订单号。 | 20220102215400 |
| faceImg | String | 特殊可选 | 512 | 面部图片网络地址 isReq 为 2时，可不传 | https://openapi.zldqy.com/** |
| faceLeftImg | String | 否 | 512 | 面部左侧图片网络地址 | https://openapi.zldqy.com/** |
| faceRightImg | String | 否 | 512 | 面部右侧图片网络地址 | https://openapi.zldqy.com/** |
| isReq | Int | 否 | 1 | 是否回答问题， 1 否（默认） 2 是 再次请求不扣费 | 1 |
| isReqList | Json | 否 | 1 | 问题回答格式： [{"subjectId":2,"answerCode":0}] | https://openapi.zldqy.com/** |
响应参数
| 参数 | 类型 | 是否必传 | 最大长度 | 描述 | 示例值 |
|---|---|---|---|---|---|
| code | String | 是 | 4 | 请求状态值 | 0000(其他值为请求失败) |
| msg | String | 是 | 128 | 请求状态信息 | success |
| ip | String | 是 | 128 | 请求IP | 120.0.0.1 |
| state | String | 是 | 4 | 请求数据状态： state为0000表示数据处理成功，0001表示需要回传问题；其他为失败。 | 0000 / 0001 (其他值为请求失败) |
| time | String | 是 | 10 | 服务器处理时间 | 1509465576 |
| datawrap | Array | 是 | -- | 参见下列字段说明 | -- |
说明：面诊通过同步的方式返回结果。因面诊接口较为特殊，伴有答题性逻辑，故采用请求后即时回复响应。且每个面诊诊断过程需要最多请求五次，题目不固定，方才可得到诊断建议。state为0001时，isReq应为2，提交isReqList后根据返回的新问题继续提交，直到state为0000时，系统会在datawrap返回诊断数据。当state为0001时，返回的datawrap如下：
| 字段 | 类型 | 必传 | 说明 |
|---|---|---|---|
| answer | Array | 是 | |
| ┗subjectId | Integer | 是 | 题目ID |
| ┗answerCode | Integer | 是 | 根据题型不同，具体代表数值或用户输入项； |
| subject | Array | 否 | 题目集合 |
| ┗subjectId | Integer | 是 | 题目ID |
| ┗subjectTitle | String | 是 | 题目标题 |
| ┗subjectType | Integer | 是 | 题型，数值代表具体意义：0:填空题、1:选择题 |
| ┗answer | Array | 是 | 答案列表 |
| ┗┗answerTitle | String | 是 | 答案标题 |
当state为0000时，返回的datawrap如下：
| 字段 | 类型 | 必传 | 说明 |
|---|---|---|---|
| isFinalResult | Integer | 是 | 是否是最终诊断建议，数值代表具体意义如下：0:否、1:是 |
| faceFinal | Object | 否 | 最终诊断建议；是否有值根据“isFinalResult”字段判断 |
| ┗complexionBaseExplain | String | 是 | 面诊表现症状 |
| ┗complexion | Object | 面色相关 | |
| ┗┗result | String | 是 | 面色结论 |
| ┗┗diagnosticAnalysis | String | 是 | 诊断分析 |
| ┗┗illnessHazard | String | 是 | 疾病危害 |
| ┗┗complexionDetail | String | 是 | 面色细节 |
| ┗┗affectingOrgan | String | 是 | 影响器官 |
| ┗eye | Object | 眼色相关 | |
| ┗┗result | String | 是 | 眼色结论 |
| ┗┗eyeDiagnosticAnalysis | String | 是 | 眼部诊断分析 |
| ┗┗eyeBagDiagnosticAnalysis | String | 是 | 眼袋诊断分析 |
| ┗┗relatedHazards | String | 是 | 眼部相关危害 |
| ┗chloasmas | Array | 是 | 黄褐斑诊断分析 |
| ┗┗imgUrl | String | 否 | 部位示意图 |
| ┗┗illnessAnalysis | String | 否 | 疾病分析 |
| ┗┗subTypeName | String | 否 | 具体部位名称 |
| ┗┗typeName | String | 否 | 皮肤疾病类型名称 |
| ┗┗illnessHazard | String | 否 | 疾病危害 |
| ┗┗diet | String | 否 | 日常饮食建议 |
| ┗┗illnessName | String | 否 | 疾病名称 |
| ┗┗chineseMedicine | String | 否 | 中医治疗建议 |
| ┗comedos | Array | 是 | 粉刺诊断分析 |
| ┗┗imgUrl | String | 否 | 部位示意图 |
| ┗┗illnessAnalysis | String | 否 | 疾病分析 |
| ┗┗subTypeName | String | 否 | 具体部位名称 |
| ┗┗typeName | String | 否 | 皮肤疾病类型名称 |
| ┗┗illnessHazard | String | 否 | 疾病危害 |
| ┗┗diet | String | 否 | 日常饮食建议 |
| ┗┗illnessName | String | 否 | 疾病名称 |
| ┗┗chineseMedicine | String | 否 | 中医治疗建议 |
| ┗freckles | Array | 是 | 雀斑诊断分析 |
| ┗┗imgUrl | String | 否 | 部位示意图 |
| ┗┗illnessAnalysis | String | 否 | 疾病分析 |
| ┗┗subTypeName | String | 否 | 具体部位名称 |
| ┗┗typeName | String | 否 | 皮肤疾病类型名称 |
| ┗┗illnessHazard | String | 否 | 疾病危害 |
| ┗┗diet | String | 否 | 日常饮食建议 |
| ┗┗illnessName | String | 否 | 疾病名称 |
| ┗┗chineseMedicine | String | 否 | 中医治疗建议 |
| ┗suggest | Object | 调理建议 | |
| ┗┗food | String | 是 | 食疗调理建议 |
| ┗┗medicine | String | 是 | 中医调理建议 |
| ┗program | Object | 调理方案 | |
| ┗┗diseaseTags | String | 是 | 疾病标签 |
| ┗┗symptomsIntroduction | String | 是 | 病症介绍 |
| ┗┗remarks | String | 是 | 备注 |
| ┗┗clinicalExperience | String | 否 | 临床体会 |
| ┗┗specificProgram | Array | 调理方案 | |
| ┗┗┗moxibustionOrder | String | 是 | 灸序 |
| ┗┗┗acupointHealth | Array | 艾灸调理方案 | |
| ┗┗┗┗acupointName | String | 是 | 穴位及穴数说明 |
| ┗┗┗┗moxibustionDuration | String | 是 | 每穴施灸量 |
评价此篇文档
川公网安备 51010402000968号
