常用快递API
支持国内外主流快递公司跟踪服务，包括顺丰、圆通、申通等主流快递公司。自动识别快递公司及单号，服务器毫秒响应，数据及时准确。
  • 产品介绍
  • API文档
  • 合作咨询
申请接口

功能介绍 / Introduction

  • 数据准确 · 支持国内外主流快递公司跟踪服务
  • 超低资费，多种阶梯套餐任意选择

适用于各大国内电商、跨境电商平台物流状态跟踪查询。

快速调用API / FastCall

  • 1. 常用快递查询
  • 2. 快递公司编号对应表
  • 3. 接口状态码释义
接口描述： 通过传递物流公司编码及单号，查询当前快递状态及轨迹等信息。
请求URL： https://api.jiadeapi.com/exp/index
请求方式： http get/post
调试工具： 去调试
请求Header：
名称 值
  Content-Type application/x-www-form-urlencoded
请求参数：
名称 必填 类型 说明
  key 是 String 接口请求key
  com 是 String 需要查询的快递公司编号
  no 是 String 需要查询的快递单号
  senderPhone 否 String 寄件人手机号后四位，顺丰快递需要提供senderPhone和receiverPhone 其中一个
  receiverPhone 否 String 收件人手机号后四位，顺丰快递需要提供senderPhone和receiverPhone 其中一个
返回参数：
名称 类型 说明
  error_code Int 返回码，0表示成功
  reason String 描述
  result Object 返回结果
  company String 快递公司名字
  com String 快递公司编号
  no String 快递单号
  status String 1表示此快递单的物流信息不会发生变化，此时您可缓存下来；0表示有变化的可能性
  status_detail String 详细的状态信息，可能为 null，仅作参考。其中：
PENDING 待查询
NO_RECORD 无记录
ERROR 查询异常
IN_TRANSIT 运输中
DELIVERING 派送中
SIGNED 已签收
REJECTED 拒签
PROBLEM 疑难件
INVALID 无效件
TIMEOUT 超时件
FAILED 派送失败
SEND_BACK 退回
TAKING 揽件
  list Array 物流轨迹结果列表
  datetime String 物流事件发生的时间
  remark String 物流事件的描述
返回示例参考： 
                      
{
  "reason": "查询物流信息成功",
  "result": {
    "company": "EMS",
    "com": "ems",
    "no": "1186465****99",
    "status": "1",
    "status_detail": "PENDING",
    "list": [
      {
        "datetime": "2016-06-15 21:44:04",
        "remark": "离开郴州市 发往长沙市【郴州市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-15 21:46:45",
        "remark": "郴州市邮政速递物流公司国际快件监管中心已收件（揽投员姓名：**,联系电话:）【郴州市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-16 12:04:00",
        "remark": "离开长沙市 发往贵阳市（经转）【长沙市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-17 07:53:00",
        "remark": "到达贵阳市处理中心（经转）【贵阳市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 07:40:00",
        "remark": "离开贵阳市 发往毕节地区（经转）【贵阳市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 09:59:00",
        "remark": "离开贵阳市 发往下一城市（经转）【贵阳市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 12:01:00",
        "remark": "到达  纳雍县 处理中心【毕节地区】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 17:34:00",
        "remark": "离开纳雍县 发往纳雍县阳长邮政支局【毕节地区】",
        "zone": ""
      },
      {
        "datetime": "2016-06-20 17:55:00",
        "remark": "投递并签收，签收人：单位收发章 *【毕节地区】",
        "zone": ""
      }
    ]
  },
  "error_code": 0
}
接口描述： 查询支持的快递公司列表及对应编号。如遇到不支持的快递公司，可联系商务进行新增支持。
请求URL： https://api.jiadeapi.com/exp/com
请求方式： http get/post
调试工具： 去调试
请求Header：
名称 值
  Content-Type application/x-www-form-urlencoded
请求参数：
名称 必填 类型 说明
  key 是 String 接口请求key
返回参数：
名称 类型 说明
  error_code Int 返回码，0表示成功
  reason String 描述
  result Array 返回结果
  com String 快递公司名称
  no String 快递公司编号
返回示例参考： 
                      
{
  "resultcode": "200",
  "reason": "查询支持的快递公司成功",
  "result": [
    {
      "com": "顺丰",
      "no": "sf"
    },
    {
      "com": "申通",
      "no": "sto"
    },
    {
      "com": "圆通",
      "no": "yt"
    },
    {
      "com": "韵达",
      "no": "yd"
    },
    {
      "com": "天天",
      "no": "tt"
    },
    {
      "com": "...",
      "no": "..."
    }
  ],
  "error_code": 0
}
状态码参考(error_code)：
  状态码 说明
  0 请求成功
  204301 表示请求参数错误，如单号错误、代码错误等，具体信息以接口返回为准
  204302 运单号错误
  204303 查询失败
  204304 查不到物流信息
  — —
  10001 接口请求Key校验不通过
  10008 请求的IP不在白名单
  10009 接口请求Key状态异常
  10012 请求超过次数限制
  10014 系统内部异常
  10020 接口维护
  10021 接口停用
  10023 请求频次过快，请稍后再试
 
  内容 详细
  联系电话: 159-5004-9812
  联系QQ: 3834700261
  技术支持: info@jiadeapi.com