API文档及SDK
1、系统参数
1.1、公共参数
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| app_key | String | True | 登陆虎符控制台查看 |
| customerId | String | False | 商家编码 |
| method | String | False | 方法名 |
| sign_method | String | False | 签名计算方式，目前仅支持md5 |
| format | String | False | 报文格式，目前仅支持json |
| v | String | False | API版本 1.0 |
| timestamp | String | False | yyyy-MM-dd HH:mm:ss |
| sign | String | False | 签名 |
1.2、签名算法
我们用发货单创建请求为例：
http://test.com?app_key=XXXXXXXXXXXXXXXXX&customerId=0100&method=jingdong.hufu.deliveryorder.create&sign=917DE2C2258D6DDE20EB3D6F3ED364F3&sign_method=md5×tamp=2021-05-31 10:00:00&format=json&v=1.0
输入参数为(参数 URL Decode之后再计算签名) 注：参数列表中的sign不参与计算签名，除此之外所有参数都要参与计算签名(以实际参数为准，示例只是一个demo)
app_key=XXXXXXXXXXXXXXXXX
customerId=0100
method=jingdong.hufu.deliveryorder.create
sign_method=md5
timestamp=2021-05-31 10:00:00
format=json
v=1.0
请求body为
{“a”:1}
按首字母升序排列:
app_key=XXXXXXXXXXXXXXXXX
customerId=0100
format=json
method=jingdong.hufu.deliveryorder.create
sign_method=md5
timestamp=2021-05-31 10:00:00
v=1.0
连接字符串: 连接参数名与参数值,并在首尾加上secret，此处假设secret=test，如下：
testapp_keyXXXXXXXXXXXXXXXXXcustomerId0100formatjsonmethojingdong.hufu.deliveryorder.createsign_methodmd5timestamp2021-05-31 10:00:00v1.0{“a”:1}test
生成签名 sign: 32位大写MD5值-> 211E472XXXXXXXXXXXXX288F9F368