快递100是中国领先的快递物流信息服务商,国家高新技术企业、产业互联网代表企业,是国内查询量最大的快递物流信息查询平台。为帮助所有的开发者能够解决物流查询问题,快递100一直为开发者免费开放了物流接入能力,让开发者能为自己的应用进行物流查询赋能,包括:Web接入、小程序跳转接入、API接入等。
- H5免费接入
- 小程序免费接入
- API开放平台
其中,小程序接入采用的是跳转到快递100小程序内部页面的方案,这种方案带来的问题是用户每次跳转都需要经过一个弹窗的确认,这在用户体验上无疑是比较糟糕的。如下:
为了解决这个问题,改善开发者接入物流查询能力后的用户体验,快递100决定将“快递跟踪”插件向所有第三方小程序、小程序开发服务商(包括个体小程序)免费开放。接入后小程序页面与物流查询页面可无缝衔接,体验流畅,效果好。示例效果如下:
你可以点击这里查看插件介绍
一、插件特点
“快递跟踪”小程序插件整合了快递100快递查询能力,支持全球1200+快递物流公司信息查询,具有无门槛接入、免费、体验流畅等特点。与传统的接入方式比较,具有如下优势:
接入方式对比 | 传统数据对接 | 快递100微信小程序插件对接 |
---|---|---|
对接难易度 | 数据对接较复杂 | 小程序管理后台申请使用即可 |
开发投入 | 需要产品经理、前后端开发、UI设计等大量人员投入,才能完成 | 无需团队大量人员投入 |
开发市场 | N个开发人员,一直两周 | 1个开发人员2小时内搞定 |
成本付出 | 数据接口需要付费,投入成本高 | 无需付费,零成本 |
查询覆盖度 | 查询覆盖不全,如快递公司单独对接,仅能查询单一快递品牌 | 一次性接入,即可查询全网国内外超过1200+快递公司物流信息 |
二、使用场景
- 电商/商城/团购类小程序:用户购买物品的快递物流查询
- 接龙/社群等工具类小程序:需邮寄给用户的物品的快递物流查询
- 回收/二手/维修类小程序:用户邮寄给平台/维修寄回的物品快递物流查询
- 提供快递查询服务的小程序:为用户提供快递查询服务的功能
- 其他有快递查询的需求的小程序:丰富小程序的服务场景,提供快递查询入口
如果你的应用不是小程序,或者你的应用对UI具有严格的要求,建议你使用快递100的API接入方式,API接入具备覆盖面完整、灵活、稳定、高可控的优点,具体可参考:快递100API开放市场
三、插件接入步骤
开发文档
目前“快递跟踪”插件采用的是页面模式的插件,接入成本很低,仅需申请、配置、跳转即可为小程序进行物流赋能。
1. 申请
在小程序管理后台的“设置-第三方设置-插件管理”中添加插件。开发者可登录小程序管理后台,在appid输入框输入wx6885acbedba59c14
查找插件,选择添加,待快递100审核后即可在小程序中使用“快递跟踪”插件。
2. 引入插件
打开小程序应用内的app.json
文件,在配置中增加“快递跟踪”插件的声明
{"plugins": {"kdPlugin": {"version": "1.0.0","provider": "wx6885acbedba59c14"}}
}
3. 调用插件
新增插件配置后,在小程序页面中使用链接跳转即可调用,跳转的方式有两种。
1. 使用API跳转
wx.navigateTo({url: "plugin://kdPlugin/index?num=1234567890&appName=应用名称",
})
2. 使用组件跳转
<navigator url="plugin://kdPlugin/index?num=1234567890&appName=应用名称"></navigator>
这样插件的接入就完成了,开发成本非常低。
你可以使用更多的配置参数来定制插件页面,目前可传入的参数如下表:
字段 | 说明 | 类型 | 是否必填 |
---|---|---|---|
num | 物流单号 | string | 是 |
appName | 调用插件的小程序名称 | string | 是 |
com | 快递100平台下的物流公司编码,具体参考3 | string | 否 |
mobile | 手机号的后4位,用于需要使用手机号校验的物流查询公司 | number | 否 |
title | 页面标题,默认值为“物流信息” | string | 否 |
rss | 是否展示订阅,0代表不订阅,其他值或者为空代表订阅,默认1 | number | 否 |
return | 是否展示退换货按钮,0不展示,默认展示 | number | 否 |
name | 收货人姓名 | string | 否 |
phone | 收货人电话或者手机 | string | 否 |
address | 收货人地址信息(含行政区) | string | 否 |
注意: 如小程序未传入必填字段,插件将无法正常使用
3. 快递公司编码
常见的快递公司编码表
物流公司名称 | 公司编码 |
---|---|
顺丰 | shunfeng |
EMS | ems |
邮政包裹 | youzhengguonei |
百世汇通 | huitongkuaidi |
申通 | shentong |
中通 | zhongtong |
圆通 | yuantong |
国通 | guotongkuaidi |
韵达 | yunda |
天天 | tiantian |
优速 | youshuwuliu |
京东 | jd |
宅急送 | zhaijisong |
全部快递公司编码表请点击下方链接下载查看:
快递100快递公司编码表
四、FAQ
快递100将继续致力于为开发者提供更稳定、完善、可靠的服务。如果你在接入服务的过程中有任何的问题,你可以加入我们的对接群反馈给我们。
Demo
- Github
- 码云