最新物流信息查询

我们以最新物流信息查询为例,为大家实例讲解 👉 如何使用简道云前端事件+物流接口,实现最新物流信息查询!


购买接口

首先我们先找到一个快递物流查询接口,我们以阿里云官方提供的接口为例,讲解如何配置在简道云的前端事件中配置:

点击进入阿里云 云市场


我们先购买一个免费体验套餐,然后可以在控制台-云市场-已买到的服务号中看到我们的AppCode,这是用来调用接口的凭证(后面会用到)。

分析接口

请求方式:GET

返回类型:JSON

接口的URL:

  • http://ali-deliver.showapi.com/showapi_expInfo

  • https://ali-deliver.showapi.com/showapi_expInfo

请求的Headers(服从阿里云云市场的标准鉴权方式):Authorization: APPCODE + 你自己的APPCODE

请求的Query:

名称 类型 是否必选 描述
com STRING 必选 快递公司字母简称,可以从接口"快递公司查询" 中查到该信息 如不知道快递公司名,可以使用"auto"代替,此时将自动识别快递单号所属公司(成功率99%,因为一个单号规则可能会映射到多个快递公司。如果识别失败,系统将返回可能的快递公司列表)。不推荐大面积使用auto,建议尽量传入准确的公司编码。
nu STRING 必选 单号
receiverPhone STRING 可选 收件人手机号后四位【手机号后四位填一个就行,多填以寄件人为准】、【请填写正确的信息、否则会查询不到】【查询顺丰时,为了保证效率,请尽量提供寄件人或者收件人查询】
senderPhone STRING 可选 寄件人手机号后四位【手机号后四位填一个就行,多填以寄件人为准】、【请填写正确的信息、否则会查询不到】【查询顺丰时,为了保证效率,请尽量提供寄件人或者收件人查询】

注意,这里参数是Query,这种参数是直接加在url后面的,例如我们的参数com=auto, nu=JD3884837244

我们请求时,应直接将这部分添加至url后方:http://ali-deliver.showapi.com/showapi_expInfo?com=auto&nu=JD3884837244

返回的数据:

注意,这里的data里面是一个数组,如果我们要取数组里面第一条数据的time,则json path应该为 $.showapi_res_body.data[0].time,同理context为 $.showapi_res_body.data[0].context,由于简道云目前只能按顺序索引数组里面的一条数据,例如data[0]为索引data数组里面的第一条数据,data[1]为索引data数组里面的第二条数据,不能直接取所有的数据。所以我们查询最新的物流数据,使用data[0]。


如果你要查询所有的物流数据,可以自己重新打包下接口,将数据整合成下面的格式,然后返回至简道云的多行文本字段

“data”: "时间: 2016-06-26 12:26

        状态: 已签收,签收人是:【本人】

        时间: 2016-06-25 15:31

        状态: 【陕西陇县公司】的派件员【西城业务员】正在派件

        时间: 2016-06-21 16:41

        状态: 【江苏常熟公司】的收件员【凌明】已收件"

配置前端事件


设置触发字段

请求类型 :GET

返回格式 :JSON

URL :

  • http://ali-deliver.showapi.com/showapi_expInfo
  • https://ali-deliver.showapi.com/showapi_expInfo

注意:

  • 这里的参数为query,我们直接添加至url后面
  • com 参数我们选择自动识别,即 auto
  • nu 参数来自于触发自动,所以需插入字段 单行文本控件<物流单号>


然后我们进入Header/Body的设置,如下图,Header为Authorization: APPCODE + 你自己的APPCODE。


最后,我们在最下面设置返回值格式,这里要依次对每个返回字段进行设置!


注:

json path的问题,如果你对json path规则有问题,可以使用下面的工具 https://jsonpath.com/? 进行测试,将所有的示例返回数据粘贴至左边JSON处,在JSONPath Syntax输入提取规则,即可在Results处看到提取倒的数据(假如key为中文,必须采用[‘我是中文’]的形式)。


效果演示

按照上述过程,我们已经完成了最新物流查询的前端事件配置,您可以点击下方链接进行最新物流查询测试。

点击测试:最新物流查询demo


你也可以尝试根据此教程将前端事件功能应用再更多的场景。


Peach是此帮助页面的作者。如果您对此页面的内容有任何意见,请在下方给她反馈。
有任何关于简道云的问题可拨打服务热线:400-111-0890 咨询(工作日:09:00-12:00;13:30-17:30)
本文是否对您有帮助?