查快递的包又来啦——xto
发布在Node.js之撸2015年2月2日view:2577HTML5
在文章任何区域双击击即可给文章添加【评注】!浮到评注点上可以查看详情。

好久之前发过的包,不过那个时候初学 node,包括回调设计、API 设计方面都是乱来的。

最近想把最近初学 node 的时候不科学的包重新理一遍,就从这个 xto 入手了。

首先是包的 Repo 地址:

https://github.com/XadillaX/xto

安装

安装很简单,直接

$ npm install xto --save

就好了。

为什么叫 XTO 呢?因为咱国内的很多快递都叫x通,然后英文名都叫 ztogtosto 等,于是我这个包就叫 xto 了。

使用

直接 require 进来调用 query 方法即可。

var xto = require("xto");

xto.query(NUMBER, COMPANY_NAME, function(err, express) {
    //... Do something
});

NUMBER 就是运单号,然后 COMPANY_NAME 是快递公司名、短名以及公司标识其中之一。对照表在这里

然后 callbackexpress 对象的格式结构大概是:

{
    "message": "ok",
    "nu": "1000****4443",
    "ischeck": "1",
    "com": "yuantong",
    "updatetime": "2015-02-02 15:57:18",
    "status": "200",
    "condition": "F00",
    "data": [
      {
        "time": "2014-11-06 18:32:19",
        "location": "",
        "context": "浙江省宁波市科技园区公司  已签收",
        "ftime": "2014-11-06 18:32:19"
      },
      {
        "time": "2014-11-06 09:14:58",
        "location": "",
        "context": "浙江省宁波市科技园区公司  派件中",
        "ftime": "2014-11-06 09:14:58"
      },
      {
        "time": "2014-11-06 09:04:52",
        "location": "",
        "context": "浙江省宁波市科技园区公司  已收入",
        "ftime": "2014-11-06 09:04:52"
      },
      {
        "time": "2014-11-06 05:31:40",
        "location": "",
        "context": "宁波转运中心公司  已发出",
        "ftime": "2014-11-06 05:31:40"
      },
      {
        "time": "2014-11-06 05:16:43",
        "location": "",
        "context": "宁波转运中心公司  已收入",
        "ftime": "2014-11-06 05:16:43"
      },
      {
        "time": "2014-11-06 00:21:40",
        "location": "",
        "context": "杭州转运中心公司  已打包",
        "ftime": "2014-11-06 00:21:40"
      },
      {
        "time": "2014-11-06 00:20:37",
        "location": "",
        "context": "杭州转运中心公司  已收入",
        "ftime": "2014-11-06 00:20:37"
      },
      {
        "time": "2014-11-05 20:35:27",
        "location": "",
        "context": "浙江省杭州市文三路公司  已收件",
        "ftime": "2014-11-05 20:35:27"
      }
    ],
    "state": "3"
}

其中 "state" 字段是快递状态,可以通过 xto.stateToText 进行转化成可读的中文状态,比如 3 转化后就是 "已签收"

其它

XTO 目前支持 446 家快递公司的查询,具体的快递公司已在上方连接中列出。

评论
发表评论
2年前

有点屌屌的

2年前
赞了此文章!
WRITTEN BY
機巧死月不會碼代碼
这是一个伪宅,也是一只码畜。
TA的新浪微博
PUBLISHED IN
Node.js之撸

让我们走上一条Node.js之撸吧!

我的收藏