版本V1.0
1. HTTP 方法:POST
2. 测试URL:
http://lancaremedicine.51developer.com/home/medicine/query_api
3. Header如下:
参数 |
值 |
Content-Type |
application/x-www-form-urlencoded |
4. URL参数:
参数 |
格式 |
说明 |
必须 |
app_id |
string |
应用ID(app_id),由索米提供 |
是 |
cur_time |
string |
当前UTC时间戳,从1970年1月1日0点0 分0 秒开始到现在的秒数。 |
是 |
app_token |
string |
令牌,计算方法:md5 (app_id + app_key + cur_time),3个值拼接的字符串,进行MD5哈希计算(32位小写),其中app_id和secret_key由索米提供,调用方管理。 |
是 |
注:
· app_key:接口密钥,由索米开放平台提供,调用方注意保管,如泄露,可联系索米技术人员重置;
· app_token有效期:出于安全性考虑,每个api_token的有效期为 5 分钟(用 cur_time 计算),同时 cur_time 要与标准时间同步,否则,时间相差太大,服务端会直接认为 cur_time 无效;
*api_token*生成示例(PHP):
$app_id = "abcd1234";
$app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
$cur_time = "1502607694";
$app_token = md5($api_id . $app_key . $cur_time);
5. Body中放置请求参数,参数详情如下:
参数 |
格式 |
说明 |
必须 |
query_string |
string |
用户说的话转为文字后的纯文字内容,不超过100个字符。 |
是 |
city_code |
string |
城市代码。英文字符串,不超过100个字符。具体以蓝卡方面提供为准,将来对应药品信息中的城市代码。 |
是 |
6. 返回参数
参数 |
格式 |
说明 |
status |
string |
"success":表示成功,其他表示失败。 |
data |
json |
结果数据。当status为success时有意义,否则无意义。 |
data.response_string |
string |
回答语句。预留备用,目前留空。 |
data.medicine_list |
json数组 |
药品结果项列表 |
data.medicine_list |
json数组 |
OCR结果项列表 |
data.medicine_list[0].id |
string |
药品id(自动编号,非蓝卡药品id) |
data.medicine_list[0].medicine_name |
string |
药品名称 |
data.medicine_list[0].medicine_trade_name |
string |
药品商品名 |
data.medicine_list[0].medicine_other_name |
string |
药品别名 |
data.medicine_list[0].medicine_indications |
string |
功能与主治 |
data.medicine_list[0].medicine_type |
string |
药品类型 |
data.medicine_list[0].permission_number |
string |
药品准字号 |
data.medicine_list[0].bar_code |
string |
条形码 |
data.medicine_list[0].specifications |
string |
规格 |
data.medicine_list[0].sale_unit |
string |
零售单位 |
data.medicine_list[0].supplier |
string |
供货商 |
data.medicine_list[0].manufacturer |
string |
生产厂家 |
data.medicine_list[0].is_prescription |
string |
是否处方药 |
data.medicine_list[0].lancare_price |
string |
蓝卡诊所价 |
data.medicine_list[0].member_price |
string |
付费会员价 |
data.medicine_list[0].stock_number |
string |
药品库存 |
data.medicine_list[0].match_type |
string |
匹配类型 |
data.medicine_list[0].picture_url |
string |
药品图片地址 |
data.medicine_list[0].detail_url |
string |
药品详情地址 |
data.medicine_list[0].store_id |
string |
药房id |
data.medicine_list[0].store_name |
string |
药房名称 |
data.medicine_list[0].medicine_id |
string |
药品id(蓝卡提供的药品id) |
7. 返回示例
{ "status": "success", "data": { "response_string": "", "medicine_list": [{ "id": "25", "medicine_name": "磷酸奥司他韦胶囊", "medicine_trade_name": "达菲", "medicine_other_name": "磷酸奥司他韦\/达菲", "medicine_indications": "<em>抗病毒 流行性感冒<\/em>", "medicine_type": "西药(抗生素、注射剂、其他)", "permission_number": "国药准字J20140121", "specifications": "75mg*10粒", "sale_unit": "盒", "manufacturer": "Roche S.p.A", "is_prescription": "1", "lancare_price": "221", "member_price": "221", "stock_number": "9", "match_type": "拼音", "picture_url": "", "detail_url": "", "store_id": "", "store_name": "", "medicine_id": "" }, { "id": "17", "medicine_name": "急支糖浆", "medicine_trade_name": "太极", "medicine_other_name": "急支糖浆\/太极", "medicine_indications": "<em>清热化痰 宣肺止咳 外感风热感冒 慢性支气管炎 急性支气管炎<\/em>", "medicine_type": "中成药", "permission_number": "国药准字Z50020615", "bar_code": "6918163010894 ", "specifications": "200ml", "sale_unit": "瓶", "manufacturer": "太极集团重庆涪陵制药厂有限公司", "is_prescription": "0", "lancare_price": "16.5", "member_price": "16.5", "stock_number": "3", "match_type": "拼音", "picture_url": "", "detail_url": "", "store_id": "", "store_name": "", "medicine_id": "" }] } } |
联系地址:北京市海淀区东北旺西路8号院23号楼三层306-027
联系邮箱:raelene@suomitek.com
北京索米科技有限公司 京ICP备18049577号