签名参数sign的说明
Step 1. 构造源串
源串是由3部分内容用"&"拼接起来的:a=x&b=y&...
源串构造步骤如下:
第1步:将除"sign"外的所有参数按key进行字典升序排列。 注:除非API文档中特别标注了某参数不参与签名,否则除sign外的所有参数都要参与签名。
第2步:将第1步中排序后的参数(key=value)用&拼接起来。
第3步:用&符号将HTTP请求方式(GET或者POST)拼接到第2步中的字符串后面。
源串构造示例
(由于是通用说明,这里以/api/v1/user/add作为示例,且示例中的请求串不可直接复制访问。)
1. 请求参数
username=yourname@163.com&name=lili&role=agent
2. 下面开始构造源串:
第1步:将除"sign"外的所有参数按key进行字典升序排列,排列结果为:name,role,username
第2步:将第1步中排序后的参数(key=value)用&拼接起来:
name=lili&role=agent&username=yourname@163.com
第3步:把拼接后的字符串再与安全校验码(安全校验码即您的帮助台的API通信密匙)直接连接起来 这里假设安全校验码为12345678
name=lili&role=agent&username=yourname@163.com&12345678
Step 2. 生成签名值
把最终的字符串加密,获得签名结果 sign = md5("name=lili&role=agent&username=yourname@163.com&12345678")
假设得到的签名值结果如下:
12d45c66523dd069d7c64c22fea10f34
Step 3. 最终请求地址
http://yourdomain.kf5.com/api/v1/user/add?name=lili&role=agent&username=yourname@163.com&
sign=12d45c66523dd069d7c64c22fea10f34