H5 接入指南

最近更新：2020年7月1日

接入流程图

在开放平台创建应用后，获取appId、appSecret、salt

一、header公共参数

二、生成sign（前后端公用）

1. 按照请求参数名的字母升序排列非空请求参数（包含appId），使用URL键值对的格式（即key1=value1&key2=value2…）
   拼接成字符串stringA；
2. stringA最后拼接上`salt`得到字符串`stringSignTemp`；（md5）
3. 对`stringSignTemp`进行加密运算，并将得到的字符串所有字符转换为大写，得到sign值。

graph TD
	appId --> sign
	接口参数 --> sign
	salt -.参与加密, 但不传输.-> sign
	

/**
 * 方法描述:签名字符串
 */
public static String sign(Map<String, Object> params, String salt) {
    StringBuilder sb = new StringBuilder();
    params.put("salt", salt);
    // 将参数以参数名的字典升序排序
    Map<String, Object> sortParams = new TreeMap<>(params);
    // 遍历排序的字典,并拼接a=b&c=d格式
    for (Map.Entry<String, Object> entry : sortParams.entrySet()) {
        String key = entry.getKey();
        String value =  entry.getValue().toString().trim();
        if (!StringUtils.isEmpty(value)){
            sb.append("&").append(key).append("=").append(value);
        }
    }
    String rawString = sb.toString().replaceFirst("&","");

    log.info("签名前字符串："+ rawString);
    params.remove("salt");
    String signString = md5(rawString).toUpperCase();
    log.info("签名后字符串："+signString);
    return signString;
}

三、接口列表

1. 接口名称：用户注册授权

Method：POST

(测试环境)Path：https://stg-open.adahealth.cn/api/user/v2/register

(生产环境)Path：https://open.adahealth.cn/api/user/v2/register

Header

请求体 Body

返回数据

2. 接口名称：疾病—挂号科室匹配

注：该接口仅适用产品“AI分诊”

请求体 Body

DepartmentInfo

返回数据

四、接入成功（示意图）