聚合数据

常用快递

  • 数据类型: 电子商务
  • 接口状态: 正常
  • 已连接App的数量: 50952
  • 描述: 支持大多数快递公司

接口地址: http://v.juhe.cn/exp/index

支持格式: JSON/XML

请求方式: HTTP POST/GET

请求示例: http://v.juhe.cn/exp/index?key=key&com=sf&no=575677355677

请求参数:

名称 类型 必填 说明
com string 需要查询的快递公司编号
no string 需要查询的快递单号
senderPhone int 寄件人手机号后四位,顺丰快递需要提供senderPhone和receiverPhone其中一个
receiverPhone int 收件人手机号后四位,顺丰快递需要提供senderPhone和receiverPhone其中一个
key string 在个人中心->我的数据,接口名称上方查看
dtype string 返回数据的格式,xml或json,默认json

返回字段:

名称 类型 说明
参考JSON返回示例 - -

JSON返回示例:

/* 以下内容仅作为格式上的参考 */

{
  "resultcode": "200", /* 老版状态码,新用户请忽略此字段 */
  "reason": "查询物流信息成功",
  "result": {
    "company": "EMS", /* 快递公司名字 */
    "com": "ems",
    "no": "1186465887499", /* 快递单号 */
    "status": "1", /* 1表示此快递单的物流信息不会发生变化,此时您可缓存下来;0表示有变化的可能性 */,
    "status_detail": "PENDING", /* 详细的状态信息,可能为null,仅作参考。其中:
        PENDING 待查询
        NO_RECORD 无记录
        ERROR 查询异常
        IN_TRANSIT 运输中
        DELIVERING 派送中
        SIGNED 已签收
        REJECTED 拒签
        PROBLEM 疑难件
        INVALID 无效件
        TIMEOUT 超时件
        FAILED 派送失败
        SEND_BACK 退回
        TAKING 揽件 */
    "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 /* 错误码,0表示查询正常,其他表示查询不到物流信息或发生了其他错误 */
}

XML返回示例:

<root>
	<resultcode>200</resultcode>
	<reason>查询成功!</reason>
	<result>
		<company>顺丰</company>
		<com>sf</com>
		<no>575677355677</no>
		<list>
			<item>
				<datetime>2013-06-25 10:44:05</datetime>
				<remark>已收件</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-25 11:05:21</datetime>
				<remark>快件在 台州 ,准备送往下一站 台州集散中心</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-25 20:36:02</datetime>
				<remark>快件在 台州集散中心 ,准备送往下一站 台州集散中心</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-25 21:17:36</datetime>
				<remark>快件在 台州集散中心 ,准备送往下一站 杭州集散中心</remark>
				<zone>台州市</zone>
			</item>
			<item>
				<datetime>2013-06-26 12:20:00</datetime>
				<remark>快件在 杭州集散中心 ,准备送往下一站 西安集散中心</remark>
				<zone>杭州市</zone>
			</item>
			<item>
				<datetime>2013-06-27 05:48:42</datetime>
				<remark>快件在 西安集散中心 ,准备送往下一站 西安</remark>
				<zone>西安市/咸阳市</zone>
			</item>
			<item>
				<datetime>2013-06-27 08:03:03</datetime>
				<remark>正在派件..</remark>
				<zone>西安市/咸阳市</zone>
			</item>
			<item>
				<datetime>2013-06-27 08:51:33</datetime>
				<remark>派件已签收</remark>
				<zone>西安市/咸阳市</zone>
			</item>
			<item>
				<datetime>2013-06-27 08:51</datetime>
				<remark>签收人是:已签收</remark>
				<zone>西安市/咸阳市</zone>
			</item>
		</list>
		<status>1</status>
	</result>
</root>

备注:

服务级错误码参照(error_code):

错误码 说明
204301 快递公司错误(不扣次数)
204302 运单号错误(不扣次数)
204303 查询失败(不扣次数)
204304 查不到物流信息(扣次数)
204305 寄件人或收件人手机尾号错误(不扣次数)

系统级错误码参照:

错误码 说明
10001 错误的请求KEY
10002 该KEY无请求权限
10003 KEY过期
10004 错误的OPENID
10005 应用未审核超时,请提交认证
10007 未知的请求源
10008 被禁止的IP
10009 被禁止的KEY
10011 当前IP请求超过限制
10012 请求超过次数限制
10013 测试KEY超过请求限制
10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失)
10020 接口维护
10021 接口停用

错误码格式说明(示例:200201):

2 002 01
服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

《常用快递》资费说明:

等级 价格(元) 请求次数
发展套餐 1000.00 66666
高级套餐 2500.00 200000
会员套餐 5000.00 500000

其他相关内容:

内容 详细
接口测试 API测试工具
技术支持 info@juhe.cn
联系电话 0512-62391880
QQ交流群 264591694
在线客服QQ 1794844675
商务合作QQ 603866358