同城配送账号授权接口
POST
https://order.kuaidi100.com/sameCity/order通过第三方授权获取商家账号授权码(目前仅闪送和货拉拉需通过第三方授权接口进行授权)
param数据结构:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
com | 是 | string | 快递公司,一律用小写字母,见参数字典 |
storeId | 是 | string | 授权店铺id |
callbackUrl | 是 | String | 授权后信息的信息回调地址 |
1.4 提供数据内容
{
"returnCode": "200",
"result": true,
"message": "提交成功",
"data": {
"url": "http://open.s.bingex.com/auth?response_type=code&client_id=ssTQhMCPkKfdz38Le&state=null&scope=shop_open_api&thirdStoreId=null&redirect_uri=http://api.kuaidi100.com/callback/ss/auth"
}
}
Copy
说明:点击链接进入授权,登录对应服务商的账号完成授权;授权成功后会跳转页面,保存好对应的参数,用做下单;
1.5 信息代码含义
信息代码 | 信息内容描述 | 原因及建议处理方式 |
---|---|---|
200 | 成功 | 成功 |
400 | 参数错误等 | 提交数据不完整, 检查提交的格式是否为x-www-form-urlencoded的post格式 |
500 | 服务器错误 | 快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数没有按照文档规定填写等,也会报此错误 |
501 | 重复提交 | 快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数没有按照文档规定填写等,也会报此错误 |
503 | 验证签名失败 | 请检查加密方式,param + t + key+ secret 的顺序进行MD5加密,加密后字符串转大写 |
601 | key已过期 | 没有可用单量,账号需要充值使用 |
请求参数
Body 参数application/x-www-form-urlencoded
method
string
必需
业务类型(默认:auth)
key
string
必需
授权码, 请到快递100页面申请企业版接口获取 https://api.kuaidi100.com/register
sign
string
必需
32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号secret在授权邮件里面有
t
string
必需
时间戳如:1576123932000
param
string
由其他字段拼接
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
returnCode
string
返回编码
result
boolean
必需
提交结果。true提交成功,false失败
message
string
返回报文描述
data
object
必需
url
string
授权链接
示例
{
"returnCode": "200",
"result": true,
"message": "提交成功",
"data": {
"url": "http://open.s.bingex.com/auth?response_type=code&client_id=ssTQhMCPkKfdz38Le&state=null&scope=shop_open_api&thirdStoreId=null&redirect_uri=http://api.kuaidi100.com/callback/ss/auth"
}
}
最后修改时间: 2 years ago