快递100 API
  1. 接口文档
快递100 API
  • 入门指南
    • 如何注册企业账号
    • 如何开通产品服务
    • 如何联系工作人员
    • 企业版和基础版的区别
  • 产品文档
    • 快递查询
      • 实时快递查询
        • 产品介绍
        • 接口文档
          • 实时快递查询接口
      • 快递信息推送服务
        • 产品介绍
        • 接口文档
          • 快递订阅查询快递api接口技术文档
          • 推送接口
      • 快递查询地图轨迹
        • 产品介绍
        • 接口文档
          • 快递查询地图轨迹技术文档
      • 地图轨迹推送服务
        • 产品介绍
        • 接口文档
          • 订阅接口
          • 推送接口
    • 电子面单与云打印
      • 电子面单
        • 产品介绍
        • 电子面单参数
        • 第三方平台账号授权
          • 第三方授权回调
          • 第三方平台网点&面单余额接口
          • 电子面单账号授权
        • 电子面单接口
          • 打印状态回调
          • 电子面单下单接口
          • 电子面单复打接口
        • 电子面单取消接口
      • 订单导入
        • 产品介绍
        • 接口文档
          • 提交售后(退货)订单获取任务接口
            POST
          • 售后(退货)订单获取结果推送接口
            POST
          • 快递单号回传及订单发货接口
            POST
          • 获取店铺授权超链接接口
            POST
          • 提交订单获取任务接口
            POST
          • 订单获取结果推送接口
            POST
      • 自定义打印
        • 产品介绍
        • 自定义模板打印
          • 自定义模板打印接口
          • 自定义模板打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 附件打印
          • 附件打印接口
          • 附件打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
        • 指令打印
          • 指令打印接口
          • 指令打印复打接口
          • 打印状态回调
          • 硬件状态查询接口
      • 发货单
        • 产品介绍
        • 接口文档
          • 发货单接口
          • 打印回调接口
    • 物流服务
      • 商家寄件
        • 产品介绍
        • 接口文档
          • 快递公司编码
          • 商家寄件下单接口
          • 下单回调接口
          • 商家寄件下单取消接口
          • 商家寄件下单价格接口
          • 快递信息推送接口
          • 商家寄件订单详情查询接口
          • 电子面单复打接口
      • 同城配送
        • 产品介绍
        • 参数字典
        • 同城配送接账号授权
          • 授权回调接口
          • 同城配送账号授权接口
        • 同城配送下单
          • 下单回调接口
          • 同城配送下单
        • 同城配送查询订单
        • 同城配送取消下单接口
      • C端寄件
        • 产品文档
        • 接口文档
          • C端寄件下单接口
          • 下单回调接口
          • C端寄件下单取消接口
          • C端寄件价格查询接口
          • 快递信息推送接口
    • 跨境服务
      • 国际电子面单API
        • 产品介绍
        • 参考数字典
        • 接口文档
          • 国际电子面单下单API
          • 预约取件API
          • 取消预约PI
    • 增值服务
      • 短信提醒发送
        • 产品介绍
        • 接口文档
          • 快递100短信回调请求
          • 快递100短信发送接口
      • 智能单号识别
        • 产品介绍
        • 智能识别接口说明
      • 快递面单OCR识别
        • 产品介绍
        • 快递面单OCR识别接口
      • 快递可用性查询
        • 产品介绍
        • 快递可用性接口
  • 常见问题
    • 查询类问题
      • 实时快递查询
      • 快递信息推送服务
      • 智能单号识别
      • 短信提醒发送
      • Excel表格批量查询
    • 电子面单类问题
      • 电子面单
      • 快递面单模板
      • 参数配置
      • 云打印机/云盒
    • 地图轨迹类问题
      • 快递查询地图轨迹
    • 物流类服务
      • 同城配送
      • 商家寄件
      • 个人寄件
    • 云打印类问题
      • 自定义打印
      • 云打印
      • 发货单
    • 申请与审核
      • 企业版
      • 基础版
    • 支付与支票
      • 产品价格
      • 账单与充值
      • 发票问题
    • 政策与规范
      • 商家寄件服务协议
      • 用户协议
      • 授权声明
      • 隐私政策
      • 增值服务
      • 服务协议
      • 保密协议
    • 账号与密码
      • 账号密码
      • 授权问题
    • 快递公司入驻
      • 入驻资料及审核
      • 电子面单接口示例
      • 快递公司接入快递100实时查询接口
      • 快递公司接入快递100订阅推送接口
      • 手机app快递查询接口
  1. 接口文档

获取店铺授权超链接接口

POST
https://api.kuaidi100.com/ent/shop/authorize
获取到授权超链接后,在浏览器登录授权店铺,也可以通过后台页面进行店铺授权:
https://api.kuaidi100.com/delivery/expressPrint
param数据结构
参数名称数据类型是否必填参数描述
shopTypestring是店铺类型,若使用淘宝店铺,填入:TAOBAO
callbackUrlstring否回调地址
saltString否回调参数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-Typestringapplication/x-www-form-urlencoded
请求参数(body)
参数名称数据类型是否必填参数描述
signstring否32位大写,提交订单获取任务salt非空时才会有该参数。签名,用于验证身份,按MD5 (param + salt)的顺序进行MD5加密,不需要加上“+”号
paramObject是由其他参数拼接
param数据结构
参数名称数据类型参数描述
shopTypestring店铺类型,TAOBAO:淘宝,JINGDONG:京东,TOUTIAO:抖店,PINDUODUO:拼多多,KUAISHOU:快手,WEIPINHUI:唯品会,YOUZAN:有赞,WEIDIAN:微店。
shopIdstring店铺ID
shopNameString店铺名称
param示例值
{
	"shopType": "TAOBAO",
	"shopId": "413979111",
	"shopName": "百递云商城"
}
Copy

1.6.3推送返回示例#

{
	"result": true,
	"returnCode": 200,
	"message": "成功"
}
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kuaidi100.com/ent/shop/authorize' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 'param='
响应示例响应示例
{
    "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"
    }
}

请求参数

Body 参数application/x-www-form-urlencoded
key
string 
必需
授权码,请申请企业版获取
sign
string 
必需
32位大写,签名,用于验证身份,按MD5 (param + key + secret)的顺序进行MD5加密,不需要加上“+”号
param
string 
由其他参数拼接
必需

返回响应

🟢200成功
application/json
Body
result
boolean 
必需
提交结果。true表示成功
returnCode
integer 
返回编码
必需
message
string 
返回报文描述
必需
data
object 
业务数据
必需
authorizeUrl
string 
店铺授权超链接
必需

【快递100】API开发者 微信交流群

用微信扫右侧二维码,加入【快递100】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2022-12-20 02:45:47
上一页
快递单号回传及订单发货接口
下一页
提交订单获取任务接口
Built with