智能小医开放平台接口说明 API接口规则:
传输方式 为保证交易安全性,采用HTTPS传输(推荐)
提交方式 采用POST方法提交(推荐)
数据格式 返回数据都为JSON格式
字符编码 统一采用UTF-8字符编码
签名算法 MD5
签名要求 sign验证模式下签名用的secret都采用智能医生开放平台用户密钥进行签名,请求api接口需要校验签名,详细方法请参考sign参数签名生成算法
sign参数签名生成算法

签名生成的通用步骤如下:
第一步,设所有发送或者接收到的数据为集合M,将集合M内非空参数值的参数按照参数名ASCII码从小到大排序(字典序),使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串stringA。
特别注意以下重要规则:
◆ 参数名ASCII码从小到大排序(字典序);
◆ 如果参数的值为空不参与签名;
◆ 参数名区分大小写;
◆ 验证签名时,传送的sign参数不参与签名,将生成的签名与该sign值作校验。
第二步,在stringA最后拼接上secret 得到stringSignTemp字符串,并对stringSignTemp进行MD5运算,再将得到的字符串所有字符转换为大写,得到sign值signValue。
◆ secret查看方法:登录智能医生开放平台->配置信息
举例:
假设传送的参数如下:
appid: 2018080396010666
content: 得了高血压怎么办
time_start: 1533626575
method: xiaoai.znys
version: v1.0
sign_type: MD5
1:对参数按照key=value的格式,并按照参数名ASCII字典序排序如下:
stringA="appid=2018080396010666&content=得了高血压怎么办&method=xiaoai.znys&sign_type=MD5&time_start=1533890961&version=v1.0";
2:拼接API密钥:
stringSignTemp=stringA+"&secret=192006250b4c09247ec02edce69f6a2d" //注:secret为智能医生平台设置的密钥
sign=MD5(stringSignTemp) = "8406B6CD5C275674BE6CFBB09083BE34" //注:MD5签名方式


智能小i接口规范

应用场景:
接入单位或个人申请接入通过后,使用接口调用小i接口针对请求过来的问答将有接口接收验证处理后返回对应的相关解答或提醒.

apiURL地址:https://ai.120.net/api/xiaoai

请求参数
变量名 类型 示例值 描述
appid String(32) 2018080396010666 用户的APPID
content String(32) test 问题描述 例如:怀孕了不能吃什么呢
time_start Int(10) 1533626575 当前系统时间戳
method String(32) xiaoai.znys 固定接口调用类型
version String(32) v1.0 固定版本
sign_type String(32) MD5(32) 签名算法,加密方式
sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名,详见sign签名生成算法

返回数据数据格式为JSON格式
{"return_code":"success","return_msg":"\u6210\u529f","return_data":{"content":"\u4e0a\u706b\u4e86\u600e\u4e48\u529e","detail":"\u662f\u4e0a\u706b\u5bfc\u81f4\u7684,\u5403\u4e00\u4e9b\u6d88\u708e\u836f\u548c\u6e05\u706b\u836f\u5982 \u9ec4\u8fde\u4e0a\u6e05\u7247\u7b49,\u53e3\u8154\u6e83\u75a1\u5916\u7528\u4e00\u4e9b\u897f\u74dc\u971c\u55b7\u5242\u5c31\u884c\u4e86,\u53e6\u5916\u8981\u591a\u559d\u6c34,\u591a\u5403\u4e00\u4e9b\u852c\u83dc\u6c34\u679c."},"err_code":"0"}

将返回的JSON 格式数据解析成数组为:
Array
([return_code] => success[return_msg] => 成功[return_data] => Array ([content] => 上火了怎么办(请求过来的问题)[detail] => 是上火导致的,吃一些消炎药和清火药如 黄连上清片等,口腔溃疡外用一些西瓜霜喷剂就行了,另外要多喝水,多吃一些蔬菜水果.(查询后的小i结果))[err_code] => 0
)