AAPICode URL支持的快递公司及参数说明.doc

API名称带验证码API（APICode URL）更新日期2012.8.11.APICode URL支持的快递公司及参数说明分类快递公司代码 公司名称 EemsEMSSshentong伸-通shunfeng顺丰Yyouzhengguonei中国邮政国内包裹/挂号信其他快递公司请直接使用 Open_API_API_URL2.利用APICode URL创建快递查询程序的整体步骤第一步程序利用 APICode URL 获得验证码图片，显示出来。同时，程序获取响应头Response Headers中Set-Cookie的值，将Set-Cookie中的JSESSIONID的值取出。（详见后面3.APICode URL使用说明 第二步用户输入图片中的验证码，并提交 第三步程序构建一个http请求头，将第一步中获得的JESSIONID的值赋给Cookie，然后将快递公司编码、运单号、验证码值等参数传进 API URL ，提求请求即可获得结果，最后显示出来（详见后面4.API URL使用说明） 3.APICode URL使用说明3.1 作用部分快递公司在查询时需要输入验证码，可用此API获得验证码图片和cookie等值，为查询运单信息的下一步骤作准备。 3.2 API地址/verifyCode?id=&com= 3.3 输入参数说明名称 类型 是否必需 描述 idString是身份授权key，请点 快递查询API 进行申请，此key和API URL的Key是通用的（大小敏感）comString是要查询的快递公司代码，参考1.APICode URL所支持的快递公司及参数说明（大小不敏感）3.4 返回结果说明返回一张验证码图片（图片的数据），如果所调用公司查询无需验证码，则无返回数据。 3.5 获取JSESSIONID的方法（详见后面5.2开发示范，下载包中有详细介绍的文档) 4.API URL使用说明4.1 作用查询并获得指定快递公司、快递单号的快递信息。 4.2 API地址/api?id=&com=&nu=&valicode=&show=0|1|2|3&muti=0|1&order=desc|asc 4.3 输入参数说明名称 类型 是否必需 描述 idString是身份授权Key，请到 快递查询API 进行申请（大小敏感）comString是要查询的快递公司代码，不支持中文，需要和APICode URL配合的公司见1.APICode URL所支持的快递公司及参数说明，不需要的见 Open_API_API_URL 第7章的API URL 所支持的快递公司及参数说明 。如果找不到您所需的公司，请发邮件至 kuaidikingdee 咨询（大小不敏感）nuString 是要查询的快递单号，请勿带特殊符号，不支持中文（大小不敏感）valicodeString 否有两种意义：1、用户输入的验证码，不在1.APICode URL所支持的快递公司及参数说明之列的公司请忽略； 2、如果是佳吉物流公司，则要用此参数传入电话号码，其他公司请忽略 showString否返回类型。0：返回json字符串，1：返回xml对象，2：返回html对象，3：返回text文本。如果不填，默认返回json字符串mutiStirng是返回信息数量。1:返回多行完整的信息，0:只返回一行信息。不填默认返回多行orderStirng否排序。desc：按时间由新到旧排列，asc：按时间由旧到新排列。不填默认返回倒序（大小不敏感）4.4 传JESSIONID值的方法API使用用户必须保证获取验证码的请求与当次查询请求在同一个会话（session）中进行。具体的保持会话，即传JESSIONID的方法，见后面5.2开发示范，下载包中有详细介绍的文档。 错误使用场景 API用户始终使用同一个会话与快递100API服务通信，会导致当次查询所产生的验证码与查询用户获取到的验证码不一致，导致查询失败，提示验证码错误。 正确使用场景 API用户为每次用户查询建立一个新的会话并与快递API服务通信，保证获取的验证码是有效的。 4.5 返回结果说明字段名称 字段含义 Message消息体Data数据集合Time每条数据的时间Context每条数据的状态state快递单当前的状态 。0：在途中,1：已发货，2：疑难件，3： 已签收 ，4：已退货。该状态还在不断完善中，有更多的参数需求，欢迎发邮件至 提出status查询的结果状态。0：运单暂无结果，1：查询成功，2：接口出现异常，408：验证码出错（仅适用于APICode url，可忽略) 。遇到其他情况，请按获得身份授权key的邮件中的方法获得技术支持。5.效果演示、开发示范和插件支持5.1 效果演示地址：/app/order_query.html 示例单号： SH-SDD-12060515084350、SH-SDD-12060509465242 5.2 开发示范目前提供ASP.NET、PHP和Java三个版本的开发示范，包括时序图、关键步骤代码示范和DEMO代码，请点 快递查询开发示范 下载使用。 5.3 插件支持目前提供最土团购等插件支持，请点 快递查询插件 下载使用。如果找不到您所需的插件，可以参考6.FAQ及开发支持的方式与我们联系。 6.FAQ及技术支持 FAQ：快递查询接口(API)常见问题 技术支持： 1. 发邮件至 ， 2. 论坛， 3. QQ、电话等：见获得授权key的邮件。 7、附录 API URL 所支持的快递公司及参数说明分类 快递公司代码 公司名称 AaaeAAEanxindakuaixi安信达Bbaifudongfang百福东方bhtBHTyouzhengguonei包裹/平邮/挂号信（暂不支持，请转用Open_API_APICode_URL）Ccces希伊艾斯（CCES）coe中国东方（COE）Ddatianwuliu大田物流debangwuliu德邦物流dpexDPEXdhlDHLdsukuaidiD速快递EemsEMS（暂不支持，请转用ems快递查询接口）emsE邮宝（暂不支持，请转用ems快递查询API）FfedexFedex（国际）（说明：Fedex是国际，国内的请用“lianbangkuaidi”）feikangda飞康达物流feikuaida飞快达rufengda凡客如风达Gganzhongnengda港中能达guangdongyouzhengwuliu广东邮政youzhengguonei挂号信（暂不支持，请转用ems快递接口）youzhengguonei国内邮件（暂不支持，请转用ems快递API）youzhengguoji国际邮件（暂不支持，请转用emsAPI）glsGLSHhuitongkuaidi汇通快运hengluwuliu恒路物流huaxialongwuliu华夏龙tiantian海航天天haiwaihuanqiu海外环球Jjinguangsudikuaijian京广速递| jixianda急先达jiajiwuliu佳吉物流jiayiwuliu佳怡物流jiayunmeiwuliu加运美jinyuekuaidi晋越快递Kkuaijiesudi快捷速递Llianhaowuliu联昊通longbanwuliu龙邦物流lanbiaokuaidi蓝镖快递lejiedi乐捷递（暂不支持）lianbangkuaidi联邦快递（国内）（说明：国外的请用 fedex）Mminghangkuaidi民航快递Rrufengda如风达快递Qquanchenkuaidi全晨快递quanjitong全际通quanritongkuaidi全日通quanyikuaidi全一快递quanfengkuaidi全峰快递Sshentong申通（暂不支持，请转用Open_API_APICode_URL）shentong申通E物流（暂不支持，请转用Open_API_APICode_URL）shunfeng顺丰速递（暂不支持，请转用Open_API_APICode_URL）santaisudi三态速递shenghuiwuliu盛辉物流suer速尔物流shengfengwuliu盛丰物流shangda上大物流santaisudi三态速递shandonghaihong山东海红saiodi赛澳递Ttiandihuayu天地华宇tiantian天天快递tntTNTUupsUPSWwanjiawuliu万家物流wxwl万象物流（即将支持）Xxinbangwuliu新邦物流xinfengwuliu信丰物流xingchengjibian星晨急便（暂不支持，请转用Open_API_APICode_URL）xinhongyukuaidi鑫飞鸿Yyafengsudi亚风速递yibangwuliu一邦速递youshuwuliu优速物流yuanchengwuliu远成物流yuantong圆通速递yuanweifeng源伟丰快递yuanzhijiecheng元智捷诚yuefengwuliu越丰物流yunda韵达快运yuananda源安达yuanfeihangwuliu原飞航yuntongkua