介绍

比较全的，通用的快递查询插件，支持查询快递公司列表，支持查询快递物流信息，单号自动识别

标识

调用插件的时候需要用到标识，标识是唯一的，不能重复，建议使用英文，不要使用中文，对应插件 plugin.json 中的 key 字段

• 标识：wuliu

配置

APPCODE, 到阿里云市场申请

{
  "APPCODE": "xxxx"
}

方法

下面是插件提供的一些方法

• query

  /**
   * 阿里云市场物流查询  https://market.aliyun.com/products/56928004/cmapi021863.html
   * @param no 快递单号
   * @param type 快递公司编码，不传则自动识别(准确率95%)
   */
  async query(no: string, type?: string)

返回示例

{
  "number": "780098068058",
  "type": "zto",
  "list": [
    {
      "time": "2024-03-09 11:59:26",
      "status": "【石家庄市】 快件已在 【长安三部】 签收,签收人: 本人, 感谢使用中通快递,期待再次为您服务!"
    },
    {
      "time": "2024-03-09 09:03:10",
      "status": "【石家庄市】快件已到达【长安三部】（xxx）,业务员 容xxx（xxx）正在第1次派件"
    },
    {
      "time": "2024-03-08 23:43:44",
      "status": "【石家庄市】 快件离开 【石家庄】 发往 【长安三部】"
    },
    {
      "time": "2024-03-08 21:00:44",
      "status": "【石家庄市】 快件到达 【石家庄】"
    },
    {
      "time": "2024-03-07 01:38:45",
      "status": "【广州市】 快件离开 【广州中心】 发往 【石家庄】"
    },
    {
      "time": "2024-03-07 01:36:53",
      "status": "【广州市】 快件到达 【广州中心】"
    },
    {
      "time": "2024-03-07 00:40:57",
      "status": "【广州市】 快件离开 【广州花都】 发往 【石家庄中转】"
    },
    {
      "time": "2024-03-07 00:01:55",
      "status": "【广州市】 【广州花都】（xxxx） 的 马溪 （xxxxx） 已揽收"
    }
  ],
  "deliverystatus": "3",
  "issign": "1",
  "expName": "中通快递",
  "expSite": "www.zto.com",
  "expPhone": "95311",
  "courier": "容xxx",
  "courierPhone": "15908220064",
  "updateTime": "2024-2-27 13:56:19",
  "takeTime": "2天20小时14分",
  "logo": "https://img3.fegine.com/express/zto.jpg"
}

• companyList

  /**
   * 获得所有快递公司
   * @returns
   */
  async companyList()

返回示例

{
  "AAEWEB": "AAE",
  "AOTSD": "澳天速运",
  "ANXL": "安迅物流",
  "EXFRESH": "安鲜达",
  "AJWL": "安捷物流",
  "ANTS": "ANTS",
  "ASTEXPRESS": "安世通快递"
  ......
}

调用示例

@Inject()
pluginService: PluginService;

// 获得插件实例
const instance = await this.pluginService.getInstance('wuliu');

// 调用query
const res = await instance.query('780098068058');

// 调用companyList
const res = await instance.companyList();

更新日志

• v1.0.0 (2024-03-15)
  • 初始版本