home首页
1 E邮宝、e包裹、e特快、e速宝API综述
1.1 业务简介
E邮宝、E包裹、E特快、E速宝API提供在线的运单生成、标签打印、全程跟踪等信息服务,覆盖运单的完整生命周期。
1.2 适用范围
具备一定软件开发能力并拥有自建订单系统的大中小型B2C、C2C商家,可根据自身情况,进行个性化的开发,以达到API系统对接的目的。
API基于HTTP协议实现,需要双方系统能够通过internet互联,并使用http方式进行通讯。本文档描述不涉及具体的开发语言,集成过程可使用合适的编程技术,实现基于http的数据交换方式。
1.3 API功能域分类
API数量较多,在后续建设过程中可能不断增加,但总体可划分几个域进行完善和扩充:
SHIP(发运服务)、TRACK(跟踪信息服务)、RATE(费率服务)、ADDRESS(地址服务)、LABEL(标签服务)。
1.4 API开发说明
如果您看过文档不清楚怎么开发请到shippingtool网站的帮助菜单里面看demo代码,该代码是java编写,仅供参考。
如果您在开发中出现:商品名称填写中文,但返回错误还是提示“商品中文名称不能为空,且必须包含至少2个汉字”时,请检查在调用api接口时所用的编码方式必须为UTF-8。

附加说明:集成及用户权限验证方法
系统间对接使用http协议,双方联调前,我方会为客户设置使用的版本信息和验证码,用户方每次发起http请求时, 需要在http header部填入两个属性:version及authenticate,version对应版本信息,当前版本号为:international_eub_us_1.1,authenticate对应用户的验证码,也就是客户从shippingtool获取到的授权码。
API文档下载地址:http://ship-file.oss-cn-beijing.aliyuncs.com/word/epacket_specification.docx