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分享的更多相关文章

使用聚合数据API查询快递数据-短信验证码-企业核名
有位朋友让我给他新开的网站帮忙做几个小功能,如下: 输入快递公司.快递单号,查询出这个快件的所有动态(从哪里出发,到了哪里) 在注册.登录等场景下的手机验证码(要求有一定的防刷策略) 通过输入公司名的 ...
TP5 调用快递鸟api 查询快递信息
1,去快递鸟,下载sdk https://www.kdniao.com/api-track 下载PHPsdk 2,下载下来的事PHP文件,不是以类的形式显示的,所以为了方便,我把他封装成了类,不需要封 ...
使用Unified Communications Managed API获取Lync在线会议的链接地址
最近在项目上遇到一个问题,需要能够在程序中获取Lync会议的链接地址.Lync是微软出品的一套即时通信(IM)客户端软件,配合Microsoft Lync Server使用,其前身是Microsoft ...
免费微信公众号专用h5在线电影票API
免费h5在线电影票API,通过嵌套返回的h5页面url,实现电影票购买. 接口文档:https://www.juhe.cn/docs/api/id/252,通过此申请APPKEY 接口备注:通过请求返 ...
在线音乐API的研究 (Part 2.1)
本文转载于:http://www.cnblogs.com/osmondy/p/LyricApi.html 最近,在优化一个自己写的音乐播放器.主要目的是回顾.归纳,并希望能够写出一个属于自己的comm ...
ES系列四、ES6.3常用api之文档类api
1.Index API: 创建并建立索引 PUT twitter/tweet/ { "user" : "kimchy", "post_date&quo ...
使用ShowDoc在线管理API接口文档
ShowDoc是什么每当接手一个他人开发好的模块或者项目,看着那些没有写注释的代码,我们都无比抓狂.文档呢?!文档呢?!Show me the doc !! ShowDoc就是一个非常适合IT团队的 ...
[原创] 在线音乐API的研究 (Part 2.1)
最近,在优化一个自己写的音乐播放器.主要目的是回顾.归纳,并希望能够写出一个属于自己的common lib.今天,主要是关于在线音乐API的一些分析结果.此次,主要分析的是歌词.专辑部分.在线搜索音乐 ...
HTML实现调用百度在线翻译API
HTML实现调用百度在线翻译API 本文章已收录于: <!doctype html> <html lang="en"> <head> < ...

随机推荐

Excel的数据批量替换
该篇文章照抄自:http://www.cnblogs.com/xwgli/p/5845317.html 在 Excel 中使用正则表达式进行查找与替换在 Excel 中,使用 Alt+F11 快捷 ...
ruby 制作自己的gem包
在ruby工程目录下新建一个文件:crowdSystem.gemspec.需要在lib目录下存在同一名称的ruby库文件:crowdSystem.rb
【bzoj5018】[Snoi2017]英雄联盟背包dp
题目描述正在上大学的小皮球热爱英雄联盟这款游戏,而且打的很菜,被网友们戏称为「小学生」.现在,小皮球终于受不了网友们的嘲讽,决定变强了,他变强的方法就是:买皮肤!小皮球只会玩N个英雄,因此,他也只准 ...
【bzoj3998】[TJOI2015]弦论后缀自动机+dp
题目描述对于一个给定长度为N的字符串,求它的第K小子串是什么. 输入第一行是一个仅由小写英文字母构成的字符串S 第二行为两个整数T和K,T为0则表示不同位置的相同子串算作一个.T=1则表示不同位置 ...
spring项目启动报错BeanFactory not initialized or already closed
spring项目启动的时候报如下错误: java.lang.IllegalStateException: BeanFactory not initialized or already closed - ...
:nth-child :nth-type-of用法详解
ele:nth-of-type(n) 是指父元素下ele元素里的第n个ele:nth-child(n) 是指父元素下第n个元素且这个元素为ele
【03】node 之作用域
1.什么是作用域作用域:规定了一个变量和函数可使用的范围,作用域分为两种:全局作用域.局部作用域(函数作用域) 2.NodeJS作用域 NodeJs中一个文件就是一个模块,模块中使用var定义的变量 ...
HDOJ-1671 Phone List
Phone List Time Limit: 3000/1000 MS (Java/Others) Memory Limit: 32768/32768 K (Java/Others) Probl ...
PE文件格式---节和节表
17.1.4 节表和节从排列位置来看,PE文件在DOS部分和PE文件头部分以后就是节表和多个不同的节(如图17.1中的③和④所示).要理解什么是节表,什么是节以及它们之间的关系,那就首先要了解Wi ...
【MFC - 菜单】在对话框程序中添加菜单栏（CMenu）（转）
原文转自 http://lishiqiang1988.blog.163.com/blog/static/41147912201382104631547/ VS2010的MFC对话框程序中添加菜单栏的过 ...

常用快递API及快递在线下单API分享

1.常用快递API

1.1常用快递查询API

1.2快递公司编号对照表

2.快递在线下单

2.1获取快递公司列表

2.2在线下单发快递

2.3撤销订单

2.4推送接口设置

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

随机推荐

热门专题