1诊开放平台接口文档

• 版本
• 接口概述
  • 接口规则
  • Sign计算规则
• API接口
  • 问诊接口
  • 查询用户诊单接口
    • 请求
    • 返回
  • 按照时间范围查询诊单接口
    • 请求
    • 返回
• HTTP接口
  • 问诊页面
    • 请求
  • 添加患者接口
    • 请求
    • 返回
  • 第3方药品库需要提供的接口
    • 请求
    • 返回

版本

接口概述

接口规则

1. 统一使用UTF-8编码

2. 文档中 partner 变量为具体合作方标识,需要申请

3. 1诊开放平台测试服务地址 https://yzmt.111.com.cn/

4. 1诊开放平台正式服务地址 https://yzm.111.com.cn/

5. 1诊开放平台图片服务地址 https://yzimg.111.com.cn/

Sign计算规则

• partner_key: 每个合作方的密钥。请妥善保存！
• 待签名参数Map: 每个接口规定了需要参加签名校验的参数，将这些参数按照参数名为key，参数值为value，组成Map
• 待签名参数字符串: 将待签名参数Map按key升序排序，按照key=<value>格式用&连接组成
• 待签名字符串: <待签名参数字符串>+&key=<partner_key>
• Sign: md5(<待签名字符串>)

Java8代码例子：

final String PARTENER_KEY = "REPLACE_YOUR_SECURITY_KEY_HERE";

HashMap<String, String> signArgs = new HashMap<>();
signArgs.put("user_id", "somebody@company");
signArgs.put("ts", "1496281246");
signArgs.put("other_argument", "value");

Map<String, String> sortedArgs = signArgs.entrySet().stream()
        .sorted(Map.Entry.comparingByKey())
        .collect(Collectors.toMap(Map.Entry::getKey,
                Map.Entry::getValue,
                (oldValue, newValue) ->
                        oldValue, LinkedHashMap::new));
String signString = sortedArgs.entrySet().stream()
        .map((entry) -> entry.getKey() + "=" + entry.getValue())
        .collect(Collectors.joining("&"));

signString = signString+"&key="+PARTENER_KEY;
System.out.println(signString);

byte[] signBytes = signString.getBytes();

try {
    MessageDigest md = MessageDigest.getInstance("MD5");
    byte[] md5Bytes = md.digest(signBytes);
    String md5Result = String.format("%032x",
            new BigInteger(1, md5Bytes));
    System.out.print(md5Result);
} catch (NoSuchAlgorithmException ex) {
    ex.printStackTrace();
}

输出结果：

other_argument=value&ts=1496281246&user_id=somebody@company&key=REPLACE_YOUR_SECURITY_KEY_HERE
53af7f47af43334ec842546e7c655f75

如果发现验证失败，请将signSring发给岗岭集团的联调开发技术人员，方便排查。

API接口

问诊接口

整理中…

查询用户诊单接口

请求

URL:partner/inquerylist/my

请求方式: POST

请求参数: form-data

返回

• 诊单查询结果

• 诊单对象

• 处方对象

• 药品对象

按照时间范围查询诊单接口

请求

URL:partner/inquerylist/range

请求方式: POST

请求参数: form-data

返回

HTTP接口

问诊页面

请求

URL:m/cooperation-h5/login.html

请求方式: HTTP跳转

请求参数:

添加患者接口

请求

URL:app/open/add_patient

请求方式: POST

请求参数: form-data

返回

第3方药品库需要提供的接口

请求

URL:<合作方提供>

请求方式: POST

请求参数: form-data

返回

• 页码对象

• 药品对象