文档中心
一、同城配送账号授权接口 二、授权回调接口 API调试工具

同城配送接口授权技术文档

一、同城配送账号授权接口

通过第三方授权获取商家账号授权码(目前仅闪送和货拉拉需通过第三方授权接口进行授权)

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://order.kuaidi100.com/sameCity/order

请求参数:

参数名是否必填类型说明
methodstring业务类型(默认:auth)
keystring授权码,请到快递100页面申请企业版接口获取
signstring32位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号。secret在企业管理后台获取
tstring时间戳如:1576123932000
paramparam由其他字段拼接

param数据结构:

参数名是否必填类型说明
comstring快递公司,一律用小写字母,见参数字典
storeIdstring授权店铺id
callbackUrlString授权后信息的信息回调地址

1.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
urlstring授权链接

1.4 提供数据内容

请求参数示例

method = auth
key = *******
sign = 4BBDE07660E5EFF90873642CFAE9A8DD
t = 1470304729724
param = {
	"com": "shansong",
	"storeId": "100000***111",
	"callbackUrl": "http://www.baidu.com"
}

返回结果示例

{
  "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"
  }
}

说明:点击链接进入授权,登录对应服务商的账号完成授权;授权成功后会跳转页面,保存好对应的参数,用做下单;

1.5 信息代码含义

信息代码信息内容描述原因及建议处理方式
200成功成功
400参数错误等提交数据不完整, 检查提交的格式是否为x-www-form-urlencoded的post格式
500服务器错误快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数没有按照文档规定填写等,也会报此错误
501重复提交快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数没有按照文档规定填写等,也会报此错误
503验证签名失败请检查加密方式,param + t + key+ secret 的顺序进行MD5加密,加密后字符串转大写
601key已过期没有可用单量,账号需要充值使用

二、授权回调接口

授权成功后自动回调授权信息。

2.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

2.2 请求地址

https://order.kuaidi100.com/sameCity/order

请求参数:

参数名是否必填类型说明
paramstring参数主体

2.3 返回结果

字段类型说明备注
resultboolean提交结果true提交成功,false失败
returnCodestring返回编码
messagestring返回报文描述
datadata

data数据结构

字段类型说明备注
partnerIdstring授权partnerId
partnerKeyString授权key
comString快递公司编码
expireTimeString过期时间

2.4 提供数据内容

入参例子

{
    "returnCode": "200",
    "result": true,
    "message": "提交成功",
    "data": {
        "com": "shansong",
        "partnerId": "863B2B9A8A934014B39E1B237D2AD7D3",
        "expireTime": "2022-03-12 17:16:25"
     }
} 

要求返回结果

{
    "returnCode": "200",
    "result": true,
    "message": "成功"
}

2.5 推送响应报文及错误码解释

字段名称字段含义
resulttrue表示成功,false表示失败。如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃
returnCode200: 提交成功 500: 服务器错误 其他错误请自行定义
message返回的提示