亿保健保服务平台和快问中医的对接

摘要
本文主要描述快问中医为亿保健保服务平台提供的接口的对接形式。
接口规范
接口协议： http（测试），https（正式）
测试域名： api.kwmzy.com
正式域名：（预计）https://api.kw13.cn
文本编码： UTF8
1.加密协议及方法、参数形式，参照微信支付规范： https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=4_3
第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。
特别注意以下重要规则：
.◆ 参数名ASCII码从小到大排序（字典序）；
.◆ 如果参数的值为空不参与签名；
.◆ 参数名区分大小写；
.◆ 验证调用返回或微信主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
.◆ 微信接口可能增加字段，验证签名时必须支持增加的扩展字段
第二步，在stringA最后拼接上key得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。

2.快问给接口方调用方分配测试用户和Key：
用户：yibao
Key：123456
正式环境的用户名、key待定
接口参数里面总是包含两个参数：

[
'account' => 'yibao', // 必填，账号
'nonce_str' => getNonceStr(), // 必填，随机参数
'sign' => 'yibao', // 必填，加密串
]
因以上参数是每次必填且存放在请求主体而不是请求头，获得加密参数后追加到各个接口的参数列表中，下面不再列出以上参数。

返回数据：
{
"statusCode": 200, // 请求成功返回200，参数错误：400，签名错误：401
"data": {
},
"msg":
}
例子：
原始数数（不含sign）：
{
"doctor_id":"3799",
"name":"商品名",
"show_detail":"Y",
"type":"Other",
"sale_channel":"Prescription",
"image":"https://www.baidu.com",
"cost":"1.1",
"price":"1.2",
"mall_price":"1.5",
"promotion_price":"1.0",
"unit":"克",
"standard":"规格",
"storage":"贮藏",
"package":"包装",
"usage":"用法用量",
"component":"配方",
"function":"功能主治",
"notes":"注意事项",
"source":"出处",
"pres_song":"方歌",
"stock":"100",
"order":"0",
"state":"OnSale",
"self_factor":"0",
"f_s_factor":"0",
"f_h_factor":"0",
"mall_factor":"0",
"description":"",
"single_ship_price":"0",
"free_ship_price_count":"0",
"likes":"0",
"sales":"0",
"account":"yibao",
"goods_no":"0001",
"product_code":"0001",
"nonce_str":"6spbkn5twoezyljcj6ch8wctwv9uddi1"
}

签名步骤一：按字典序排序参数：
"account=yibao&component=配方&cost=1.1&doctor_id=3799&f_h_factor=0&f_s_factor=0&free_ship_price_count=0&function=功能主治&goods_no=0001&image=https://www.baidu.com&likes=0&mall_factor=0&mall_price=1.5&name=商品名&nonce_str=6spbkn5twoezyljcj6ch8wctwv9uddi1¬es=注意事项&order=0&package=包装&pres_song=方歌&price=1.2&product_code=0001&promotion_price=1.0&sale_channel=Prescription&sales=0&self_factor=0&show_detail=Y&single_ship_price=0&source=出处&standard=规格&state=OnSale&stock=100&storage=贮藏&type=Other&unit=克&usage=用法用量"

签名步骤二：在string后加入KEY：
account=yibao&component=配方&cost=1.1&doctor_id=3799&f_h_factor=0&f_s_factor=0&free_ship_price_count=0&function=功能主治&goods_no=0001&image=https://www.baidu.com&likes=0&mall_factor=0&mall_price=1.5&name=商品名&nonce_str=6spbkn5twoezyljcj6ch8wctwv9uddi1¬es=注意事项&order=0&package=包装&pres_song=方歌&price=1.2&product_code=0001&promotion_price=1.0&sale_channel=Prescription&sales=0&self_factor=0&show_detail=Y&single_ship_price=0&source=出处&standard=规格&state=OnSale&stock=100&storage=贮藏&type=Other&unit=克&usage=用法用量&key=123456

签名步骤三：MD5加密：
"eb62585a5606414b8ffa919422bc1507"

签名步骤四：所有字符转为大写：
"EB62585A5606414B8FFA919422BC1507"
最后发起请求
请求方法: POST数据类型: JSON响应类型: JSON
请求主体：
{"doctor_id":"3799","name":"商品名","show_detail":"Y","type":"Other","sale_channel":"Prescription","image":"https://www.baidu.com","cost":"1.1","price":"1.2","mall_price":"1.5","promotion_price":"1.0","unit":"克","standard":"规格","storage":"贮藏","package":"包装","usage":"用法用量","component":"配方","function":"功能主治","notes":"注意事项","source":"出处","pres_song":"方歌","stock":"100","order":"0","state":"OnSale","self_factor":"0","f_s_factor":"0","f_h_factor":"0","mall_factor":"0","description":"","single_ship_price":"0","free_ship_price_count":"0","likes":"0","sales":"0","account":"yibao","goods_no":"0001","product_code":"0001","nonce_str":"6spbkn5twoezyljcj6ch8wctwv9uddi1","sign":"EB62585A5606414B8FFA919422BC1507"}
响应：
{
"statusCode": 200,
"msg": "创建商品成功"
}

默认文档