一、什么是快递查询接口(API)？

快递查询接口(或快递查询API)，是指快易查138对外开放的应用程序接口，开发人员能够通过调用该接口与易查138进行交互，并基于该接口开发自己的快递查询应用程序，从而达到不用访问易查138网站便能获得快递单信息、并对这些信息进行更加灵活的处理的目的。

二、快递查询接口(API)有什么用途？适用于哪些企业或人群？

1、快递查询接口(API)有用途有很多，最常用的几种如下：

- 让顾客登录您的网站后，直接在“我的订单”页面内就能看到订单的物流状态。
- 能开发自动的、批量查单功能，自动筛选出“已签收”、“疑难件”等状态的单号，减轻跟单人员的压力。
- 改变订单的状态与交易流程，例如只要运单号变为“已签收”，就能让订单变为可以确认退换货等。
- 核销售人员，评估与选择快递公司，根据“已签收”的运单数，就能算出销售人员的业绩。
- 助结算运费，用API找出“已签收”的单及签收时间，便能轻松应对货到付款的结算与对帐。
- 短信提醒用户运单的最新状态，既能安抚用户，还能在短信中加入广告。
- 更为详细的介绍、应用案例，请点应用案例进行查看。

2、只要涉及经常发货、寄快递的人群或企业，都能用使用。最常见的几种企业与场景如下：

- 电商网站：例如零售B2C、团购、B2B、批发分销站、C2C、本地生活交易等网站。
- 在线管理系统：订单处理平台、订货平台、发货平台、分销系统、渠道管理系统、客户管理系统CRM等。
- 企业内部系统：供应商管理系统、经销商管理系统、ERP、进销存、订单处理系统、OA系统等。

三、有哪些类型，我该怎么选？

我们现在一共有3种API，分别是：快递查询API(API URL)、HtmlAPI、跳转API(Chaxun URL)，另外还提供专用的iframe页面供嵌套使用，以下是他们的各项参数对比，您可以根据您的需要进行选择。

	快递查询API[推荐]	HtmlAPI	跳转API（包括PC端和手机端）	Iframe页
费用说明	免费	免费	免费	免费
请求方式	可自定义，可以自动填写公司与单号	可自定义，可以自动填写公司与单号	可自定义，可以自动填写公司与单号	不可自定义，需要用户手动选择公司、输入单号
结果展示	通过接口直接返回JSON、XML等格式的结果，可以对结果进行灵活处理	返回HTML格式的结果，当不稳定时，需要用户手动输一次验证码	跳到易查138的网站展示结果	在页面内显示结果，页面与结果的格式已固定
其他返回参数	返回已发货、在途中、已签收、疑难件等状态参数	无	无	无
支持公司	绝大多数公司	支持EMS、顺丰和申通在内的所有公司	所有	所有
使用次数限制	2000次/天，不支持多线程	最多2000次/天，不支持多线程	无	无
稳定性	强	强，无需人工维护	最强，无需人工维护	强，无需人工维护
开发难度	中	中	低	超低
提供支持	提供开发示范与shopex等插件	提供开发示范	提供开发示范	提供调用示范
是否需要申请	是	是	否	否
申请条件	加上友情链接	加上友情链接	无	无
开通流程	第一步：申请授权key 申请方法 第二步：接收授权key，并将您的需求与技术文档交给技术同事 第三步：开发		第一步： 阅读技术文档（PC端）、 技术文档（手机端） 第二步：直接开发	第一步：阅读技术文档 第二步：直接开发
	立即申请		立即使用	立即使用

这些产品都不符合您要求？您可以转用企业版，详情请点申请企业版后提交，提交后5分钟给您邮件回复，发邮件至kuaidi@yicha138.com咨询。

四、支持哪些快递公司？

1、快递查询API所支持的公司请参考：API URL说明>>

2、HtmlAPI所支持的公司请参考：API URL说明>>

3、跳转API：支持所有易查138网站上有的快递公司

4、Iframe页：详细请参考各个iframe页

五、怎样申请使用？有什么条件？

1、快递查询API和HtmlAPI：

- 这两种API的授权key是通用的，即只要获得两者中的任何一种的授权key，就能同时使用这两种API。
- 申请条件：申请这两种API的条件是要在贵网站上先加上我们友情链接，不需要付费。
- 申请方法：

第一步：添加易查138友情链接/openapi/
第二步：填写并提交使用申请表；
第三步：等待工作人员对申请资料进行审核（期间工作人员会联系申请者）；
第四步：若审核通过，邮箱会收到一封写有授权Key、API文档、获得技术支持方法等信息的通知。

2、跳转API：不需要申请，可以直接使用。

3、Iframe页：不需要申请，可以直接调用。

六、怎样申请超过2000次/天、支持所有快递公司的高级版本？

您可以转用企业版，详情请点申请企业版后提交，提交后5分钟给您邮件回复，或发邮件至kuaidi@yicha138.com咨询。

七、怎样获得技术支持？

（1）在我们发放授权key的邮件中，会附上获得技术支持的方法；

八、申请API一般要多久才能审核？

我们的审核专员处理用户申请一般在1-2个工作日内完成，如遇申请的人数过多或遇国家法定节假日时会有适当延迟，请谅解。另外，提交申请后，审核专员会通过QQ等方式联系申请者，收到请求后请及时回复"API审核"等信息。如果联系不上，审核会相对延后, 请保持QQ在线状态。

九、为什么我的申请无法通过审核？

通常是因为您填写的资料不全、网址无法访问、您的网站尚未添加易查138网站的链接、应用描述不清晰等，另外，如果确认您的需求可以通过我们的快递查询代码满足，并经您同意，我们也会帮您取消申请。

十、我的朋友可以用我的key吗？

一个Key原则上只能用于一个网站或软件，如果您有多个网站，建议分开来进行申请。另外，为了您的利益，请妥善保管您的Key，勿向他人或其他组织透露。对于已被盗用的Key，我们将会作禁用处理。

十一、易查138的API更新历史如下：

2011-10-12 API URL增加参数；

2011-11-08 新增APICode URL；

2012-05-03 撤下APIOne URL；升级APICode URL；

2012-05-05 在API URL返回结果中，增加一个叫condition的参数。