签名参数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