1.常用快递API

支持顺丰、EMS、申通、圆通、韵达、汇通、中通、天天、德邦、全峰等主流快递公司。

文档地址:https://www.juhe.cn/docs/api/id/43

1.1常用快递查询API

接口地址:http://v.juhe.cn/exp/index
支持格式:json/xml
请求方式:http post/get
请求示例:http://v.juhe.cn/exp/index?key=key&com=sf&no=575677355677
调用样例及调试工具:API测试工具
请求参数说明:

  名称 类型 必填 说明
  com string 需要查询的快递公司编号
  no string 需要查询的订单号
  key string 应用APPKEY(应用详细页查询)
  dtype string 返回数据的格式,xml或json,默认json
返回参数说明:

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

{
"resultcode":"200",/*返回标识码*/
"reason":"查询成功!",
"result":{
"company":"顺丰",
"com":"sf",
"no":"575677355677",
"list":[
{
"datetime":"2013-06-25 10:44:05", /*时间*/
"remark":"已收件", /*描述*/
"zone":"台州市" /*区域,视快递公司情况,不保证一定有信息*/
},
{
"datetime":"2013-06-25 11:05:21",
"remark":"快件在 台州 ,准备送往下一站 台州集散中心 ",
"zone":"台州市"
},
{
"datetime":"2013-06-25 20:36:02",
"remark":"快件在 台州集散中心 ,准备送往下一站 台州集散中心 ",
"zone":"台州市"
},
{
"datetime":"2013-06-25 21:17:36",
"remark":"快件在 台州集散中心 ,准备送往下一站 杭州集散中心 ",
"zone":"台州市"
},
{
"datetime":"2013-06-26 12:20:00",
"remark":"快件在 杭州集散中心 ,准备送往下一站 西安集散中心 ",
"zone":"杭州市"
},
{
"datetime":"2013-06-27 05:48:42",
"remark":"快件在 西安集散中心 ,准备送往下一站 西安 ",
"zone":"西安市/咸阳市"
},
{
"datetime":"2013-06-27 08:03:03",
"remark":"正在派件..",
"zone":"西安市/咸阳市"
},
{
"datetime":"2013-06-27 08:51:33",
"remark":"派件已签收",
"zone":"西安市/咸阳市"
},
{
"datetime":"2013-06-27 08:51",
"remark":"签收人是:已签收 ",
"zone":"西安市/咸阳市"
}
]
"status": "1", /*0或1。0表示此单号信息还有更新的可能;1表示此单号信息不会再更新
(签收、退回等最终状态),您可将单号信息存入数据库,不必再次往聚合发送更新请求。*/
}
}
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>

1.2快递公司编号对照表

接口地址:http://v.juhe.cn/exp/com
支持格式:json/xml/jsonp
请求方式:http post get
请求示例:http://v.juhe.cn/exp/com?key=key
调用样例及调试工具:API测试工具
请求参数说明:

  名称 类型 必填 说明
         
返回参数说明:

  名称 类型 说明
       
JSON返回示例:

{
"resultcode":"200",
"reason":"成功的返回",
"result":[
{
"com":"顺丰",
"no":"sf"
},
{
"com":"申通",
"no":"sto"
},
{
"com":"圆通",
"no":"yt"
},
{
"com":"韵达",
"no":"yd"
},
{
"com":"天天",
"no":"tt"
},
{
"com":"EMS",
"no":"ems"
},
{
"com":"中通",
"no":"zto"
},
{
"com":"汇通",
"no":"ht"
}
]
}

2.快递在线下单

应用场景:普通用户在线向快递公司在线下单,快递公司收到申请快递员上门取件

接口文档:https://www.juhe.cn/docs/api/id/229

2.1获取快递公司列表

接口地址:http://v.juhe.cn/expressonline/test/getCarriers.php
支持格式:json/xml
请求方式:http get/post
请求示例:http://v.juhe.cn/expressonline/test/getCarriers.php?key=APPKEY
接口备注:获取支持的快递公司列表
调用样例及调试工具:API测试工具
请求参数说明:

  名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  ex_category string recommend:推荐快递公司;
返回参数说明:

  名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
"reason": "查询成功",
"result": [
{
"carrier_code": "ems",/*快递公司代码*/
"carrier_phone": "11183",/*快递公司电话*/
"carrier_name": "EMS"/*快递公司名称*/
},
{
"carrier_code": "zhongtong",
"carrier_phone": "021-39777777",
"carrier_name": "中通快递"
},
{
"carrier_code": "yuantong",
"carrier_phone": "021-69777888",
"carrier_name": "圆通速递"
},
{
"carrier_code": "zjs",
"carrier_phone": "400-6789-000",
"carrier_name": "宅急送"
},
{
"carrier_code": "debang",
"carrier_phone": "400-830-5555",
"carrier_name": "德邦物流"
},
{
"carrier_code": "huitong",
"carrier_phone": "021-62963636",
"carrier_name": "百世汇通"
},
{
"carrier_code": "shunfeng",/*快递公司编码*/
"carrier_phone": "400-811-1111",/*快递公司电话*/
"carrier_name": "顺丰速运"/*快递公司名称*/
},....
],
"error_code": 0
}

XML返回示例:

<?xml version="1.0" encoding="utf-8"?>
<root>
<reason>查询成功</reason>
<result>
<item>
<carrier_code>ems</carrier_code>
<carrier_phone>11183</carrier_phone>
<carrier_name>EMS</carrier_name>
</item>
<item>
<carrier_code>zhongtong</carrier_code>
<carrier_phone>021-39777777</carrier_phone>
<carrier_name>中通快递</carrier_name>
</item>
<item>
<carrier_code>yousu</carrier_code>
<carrier_phone>400-1111-119</carrier_phone>
<carrier_name>优速快递</carrier_name>
</item>
<item>
<carrier_code>quanfeng</carrier_code>
<carrier_phone>400-100-0001</carrier_phone>
<carrier_name>全峰快递</carrier_name>
</item>
<item>
<carrier_code>yuantong</carrier_code>
<carrier_phone>021-69777888</carrier_phone>
<carrier_name>圆通速递</carrier_name>
</item>
<item>
<carrier_code>zjs</carrier_code>
<carrier_phone>400-6789-000</carrier_phone>
<carrier_name>宅急送</carrier_name>
</item>
<item>
<carrier_code>debang</carrier_code>
<carrier_phone>400-830-5555</carrier_phone>
<carrier_name>德邦物流</carrier_name>
</item>
<item>
<carrier_code>huitong</carrier_code>
<carrier_phone>021-62963636</carrier_phone>
<carrier_name>百世汇通</carrier_name>
</item>
<item>
<carrier_code>shunfeng</carrier_code>
<carrier_phone>400-811-1111</carrier_phone>
<carrier_name>顺丰速运</carrier_name>
</item>
</result>
<error_code>0</error_code>
</root>

2.2在线下单发快递

接口地址:http://v.juhe.cn/expressonline/test/expressSend.php
支持格式:json/xml
请求方式:http post
请求示例:http://v.juhe.cn/expressonline/test/expressSend.php?key=APPKEY&send_method=addOrderInfoMes&order_no=......所有参数(请转换成post形式提交)
接口备注:提供两种模式,(1)普通发快递:在线向快递公司在线下单;(2)异步发快递: 用户将订单信息提交到平台
注:开发测试,下单成功后请及时撤销订单,否则快递公司会打电话上门取件
调用样例及调试工具:API测试工具
请求参数说明:

  名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  send_method string 接口方法名称
(addOrderInfoMes:普通发快递,
(1)普通用户在线向快递公司在线下单,
(2)快递公司收到申请快递员上门取件;
addOrderInfoAsy:异步发快递,
(1)用户将订单信息提交到开放平台,
(2)开放平台通过订单状态推送用户发件结果,
(3)快递公司收到申请快递员上门取件)
  order_no string 订单编号10-32位唯一的数字字符串(例:20160129121200956523)
  isWaybill string 是否为电子运单( 1 普通订单(默认为1),暂仅支持普通)
  carrier_code string 快递公司编码.建议使用宅急送(zjs)进行功能和流程测试
  sender_name string 发件人姓名
  sender_telphone string 发件人手机号码
  sender_phone string 发件人固定电话
  sender_province_name string 发件地址省名称
  sender_city_name string 发件地址市名称
  sender_district_name string 发件地址区名称
  sender_address string 发件地址详细信息
  sender_post_code string 发件地址邮政编码
  receiver_name string 收件人姓名
  receiver_telphone string 收件人手机号码
  receiver_phone string 收件人固定电话
  receiver_province_name string 收件地址省名称
  receiver_city_name string 收件地址市名称
  receiver_district_name string 收件地址区名称
  receiver_address string 收件地址详细信息
  receiver_org_name string 收件机构
  receiver_post_code string 收件地址邮政编码
  remark string 备注
  item_weight double 重量(double,单位kg)
  item_name string 货物名称
  item_spec string 规格
  send_start_time string 预约开始时间(时间格式为:yyyy-MM-dd HH:mm:ss)
  send_end_time string 预约结束时间(时间格式为:yyyy-MM-dd HH:mm:ss)
返回参数说明:

  名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
"reason": "下单成功",
"result": {
"order_no":"20160129121200956523",/*订单编号*/
"carrier_code":"zjs"/*快递公司编号*/
},
"error_code": 0
}

2.3撤销订单

接口地址:http://v.juhe.cn/expressonline/test/cancleSend.php
支持格式:json/xml
请求方式:http post
请求示例:http://v.juhe.cn/expressonline/test/cancleSend.php?key=APPKEY&
接口备注:用户下单后,不想发快递了,可以及时取消;由于快递公司IT系统原因,暂支持 宅急送、优速、百世汇通、圆通、中通、德邦快递公司撤销发件
调用样例及调试工具:API测试工具
请求参数说明:

  名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  order_no string 订单编号 10-32位唯一的数字字符串
  carrier_code string 快递公司编码
返回参数说明:

  名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
"reason": "取消成功",
"result": {
"order_no": "20160129121200956523",/*订单号*/
"carrier_code": "zjs"/*快递公司编码 (宅急送)*/
},
"error_code": 0
}

2.4推送接口设置

接口地址:http://v.juhe.cn/expressonline/setPush.php
支持格式:json/xml
请求方式:http post
请求示例:http://v.juhe.cn/expressonline/setPush.php?key=APPKEY&
接口备注:用户设置订单状态更新信息推送接口 (测试阶段不予以推送状态更新)
调用样例及调试工具:API测试工具
请求参数说明:

  名称 类型 必填 说明
  dtype string 结果数据返回类型(json/xml)
  key string 您申请的appkey
  name string 公司名
  state_method string 订单状态更新推送地址
  content_method string 物流信息更新推送地址
返回参数说明:

  名称 类型 说明
  error_code int 返回码
  reason string 返回说明
  result string 返回结果集
JSON返回示例:
{
"reason": "成功的返回",
"result": {
"name": "",/*公司名称或其他说明文字*/
"state_method": "您接收订单状态更新信息推送的接口(例:http://test.com/test.php)",/*订单状态更新推送地址*/
"content_method": "您接收订物流信息更新推送的接口(例:http://test.com/test.php)",/*物流信息更新推送地址*/
"key": APPKEY
},
"error_code": 0
} /*订单状态推送,数据格式以及参数说明.(注:操作完成后输出:success字符串)*/
{
"orders": [
{
"order_no": "20160201090120458263",/*订单号*/
"carrier_code": "zjs",/*快递公司编码*/
"status": "4",/*订单状态:0:下单成功,1:下单失败,2:撤单成功,3:撤单失败,4:接单成功,5:接单失败,
6:揽收成功,7:揽收失败,8:在途,9:派件扫描,10:签收成功,11:签收失败*/
"time": "2015-01-15 09:33:32",/*操作时间*/
"content": "工业园区网点接单,电话1234568"/*内容*/
}
]
} /*物流信息推送,数据格式以及参数说明.(注:操作完成后输出:success字符串)*/
{
"orders": [
{
"order": {
"bill_code": "350301727598", /*快递公司运单号*/
"order_no": "20160201090120458263", /*订单号*/
"carrier_code": "zjs", /*快递公司编码*/
"status": "4"
},
"data": [/*物流信息list*/
{
"time": "2014-11-14 15:51:59",/*操作时间*/
"content": "到太原市【太原分拨中心】"/*操作内容*/
},
{
"time": "2014-11-14 01:57:02",
"content": "北京市【北京分拨中心】,正发往【太原分拨中心】"
},
{
"time": "2014-11-14 01:55:27",
"content": "到北京市【北京分拨中心】"
}
]
}
]
}

  

常用快递API及快递在线下单API分享的更多相关文章

  1. 使用聚合数据API查询快递数据-短信验证码-企业核名

    有位朋友让我给他新开的网站帮忙做几个小功能,如下: 输入快递公司.快递单号,查询出这个快件的所有动态(从哪里出发,到了哪里) 在注册.登录等场景下的手机验证码(要求有一定的防刷策略) 通过输入公司名的 ...

  2. TP5 调用快递鸟api 查询快递信息

    1,去快递鸟,下载sdk https://www.kdniao.com/api-track 下载PHPsdk 2,下载下来的事PHP文件,不是以类的形式显示的,所以为了方便,我把他封装成了类,不需要封 ...

  3. 使用Unified Communications Managed API获取Lync在线会议的链接地址

    最近在项目上遇到一个问题,需要能够在程序中获取Lync会议的链接地址.Lync是微软出品的一套即时通信(IM)客户端软件,配合Microsoft Lync Server使用,其前身是Microsoft ...

  4. 免费微信公众号专用h5在线电影票API

    免费h5在线电影票API,通过嵌套返回的h5页面url,实现电影票购买. 接口文档:https://www.juhe.cn/docs/api/id/252,通过此申请APPKEY 接口备注:通过请求返 ...

  5. 在线音乐API的研究 (Part 2.1)

    本文转载于:http://www.cnblogs.com/osmondy/p/LyricApi.html 最近,在优化一个自己写的音乐播放器.主要目的是回顾.归纳,并希望能够写出一个属于自己的comm ...

  6. ES系列四、ES6.3常用api之文档类api

    1.Index API: 创建并建立索引 PUT twitter/tweet/ { "user" : "kimchy", "post_date&quo ...

  7. 使用ShowDoc在线管理API接口文档

    ShowDoc是什么 每当接手一个他人开发好的模块或者项目,看着那些没有写注释的代码,我们都无比抓狂.文档呢?!文档呢?!Show me the doc !! ShowDoc就是一个非常适合IT团队的 ...

  8. [原创] 在线音乐API的研究 (Part 2.1)

    最近,在优化一个自己写的音乐播放器.主要目的是回顾.归纳,并希望能够写出一个属于自己的common lib.今天,主要是关于在线音乐API的一些分析结果.此次,主要分析的是歌词.专辑部分.在线搜索音乐 ...

  9. HTML实现调用百度在线翻译API

    HTML实现调用百度在线翻译API 本文章已收录于:   <!doctype html> <html lang="en"> <head> < ...

随机推荐

  1. linux开机关机自启动或自关闭服务的方式

    背景 由于迁移部门jira和confluence到linux,需要设置这两个服务在开机或关机时能够自动启动或关闭.这里我就拿配置confluence过程来记录. 方式1:chkconfig 特点:ch ...

  2. 如何从fragment跳到activity再从activity返回(finish()方法返回)刷新fragemnt页面

    代码改变世界 如何从fragment跳到activity再从activity返回(finish()方法返回)刷新fragemnt页面 广播方法实现Fragment页面刷新 fragment中重写onA ...

  3. BZOJ 1083:[SCOI2005]繁忙的都市(最小生成树)

    1083: [SCOI2005]繁忙的都市 Description 城市C是一个非常繁忙的大都市,城市中的道路十分的拥挤,于是市长决定对其中的道路进行改造.城市C的道路是这样分布的:城市中有n个交叉路 ...

  4. vuemock数据

    http://www.jianshu.com/p/ccd53488a61b dev.server.js 61 行 app.use('/mock',express.static('./mock'))

  5. [暑假集训--数论]poj2115 C Looooops

    A Compiler Mystery: We are given a C-language style for loop of type for (variable = A; variable != ...

  6. mysql启动错误1067的解决

    安装后MYSQL5后,发现启动出错,有时启动正常,但加接时马上出错. 出错代码:1067 解决办法如下: 删除%windows%/my.ini    删除其它地方的my.ini    在mysql安装 ...

  7. css命名推荐

    CSS命名推荐规范:个人收藏 方便查阅 页面结构: 容器: container/wrap 整体宽度:wrapper 页头:header 内容:content 页面主体:main 页尾:footer 导 ...

  8. LeetCode OJ--Combination Sum **

    https://oj.leetcode.com/problems/combination-sum/ 给一列数,3 2 1 3 3 8 7 9 ,每个数可以重复多次,给target 7, 问可以加起来得 ...

  9. 牛客网 牛客小白月赛1 F.三视图

    F.三视图   链接:https://www.nowcoder.com/acm/contest/85/F来源:牛客网     这个题自己想一下三维的,正视图和左视图中y轴为行数,x轴和z轴是列数,因为 ...

  10. ABP开发框架前后端开发系列---(1)框架的总体介绍

    ABP是ASP.NET Boilerplate的简称,ABP是一个开源且文档友好的应用程序框架.ABP不仅仅是一个框架,它还提供了一个最徍实践的基于领域驱动设计(DDD)的体系结构模型.学习使用ABP ...