获取店铺授权超链接接口
POST
https://api.kuaidi100.com/ent/shop/authorize获取到授权超链接后,在浏览器登录授权店铺,也可以通过后台页面进行店铺授权:
https://api.kuaidi100.com/delivery/expressPrint
param数据结构
参数名称 | 数据类型 | 是否必填 | 参数描述 |
---|---|---|---|
shopType | string | 是 | 店铺类型,若使用淘宝店铺,填入:TAOBAO |
callbackUrl | string | 否 | 回调地址 |
salt | String | 否 | 回调参数sign的加密参数,非空时回调才会有sign参数 |
1.6 授权成功推送
用户获取授权超链接的时候,使用到callbackUrl并且授权成功后才会推送。 每条消息推送用户接收和保存成功后,应该返回这样的响应报文:{"result":true,"returnCode":200,"message":"成功"},我方根据result等于true作为推送成功标识,其他均为推送失败。推送失败会隔半小时后重推,连续3次重推都失败则放弃该条消息的推送。
1.6.1 接口格式
POST application/x-www-form-urlencoded
1.6.2 请求地址
由贵司在获取授权超链接请求中通过callbackUrl字段提供 请求参数(header)
名称 | 类型 | 默认值 |
---|---|---|
Content-Type | string | application/x-www-form-urlencoded |
请求参数(body)
参数名称 | 数据类型 | 是否必填 | 参数描述 |
---|---|---|---|
sign | string | 否 | 32位大写,提交订单获取任务salt非空时才会有该参数。签名,用于验证身份,按MD5 (param + salt)的顺序进行MD5加密,不需要加上“+”号 |
param | Object | 是 | 由其他参数拼接 |
param数据结构
参数名称 | 数据类型 | 参数描述 |
---|---|---|
shopType | string | 店铺类型,TAOBAO:淘宝,JINGDONG:京东,TOUTIAO:抖店,PINDUODUO:拼多多,KUAISHOU:快手,WEIPINHUI:唯品会,YOUZAN:有赞,WEIDIAN:微店。 |
shopId | string | 店铺ID |
shopName | String | 店铺名称 |
param示例值
{
"shopType": "TAOBAO",
"shopId": "413979111",
"shopName": "百递云商城"
}
Copy
1.6.3推送返回示例
{
"result": true,
"returnCode": 200,
"message": "成功"
}
请求参数
Body 参数application/x-www-form-urlencoded
key
string
必需
授权码,请申请企业版获取
sign
string
必需
32位大写,签名,用于验证身份,按MD5 (param + key + secret)的顺序进行MD5加密,不需要加上“+”号
param
string
由其他参数拼接
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
必需
提交结果。true表示成功
returnCode
integer
返回编码
message
string
返回报文描述
data
object
业务数据
authorizeUrl
string
店铺授权超链接
示例
{
"result": true,
"returnCode": 200,
"message": "SUCCESS",
"data": {
"authorizeUrl": "https://oauth.taobao.com/authorize?response_type=code&client_id=21153231&redirect_uri=https%3A%2F%2Ftb.kuaidi100.com%2Fopen%2Ftaobao%2FauthToken.do&state=YXBwS2V5OnkzRXlDanJ3OW9u45698ZTFjMGEyZDA4NDA0MzI0OWE0YmYzOTkyM222ZjMw&view=web"
}
}
最后修改时间: 2 年前