1、创建批量查询任务
用POST方式，发送请求到 http://yun.zhuzhufanli.com/mini/create/必须以斜杠结尾
参数名 类型 示例值 说明
appid* int 123 联系猪猪云客服配置
outerid* string(16) p4licpye1d2fr3fa 联系猪猪云客服配置
zffs* string jinbi 支付方式只能传jinbi（是“金币”两个汉字的全拼）。接口调用需要用到金币，
kdgs* string shentong 快递公司代码，《详见表格》
kddhs* string 111111,222222,333333 快递单号集合，以半角逗号间隔，≤1万单；
若发布的是顺丰/丰网/跨越任务，要求传入对应电话号码的后四位，格式举例：111111||电话号码后4位,222222||电话号码后4位,333333||电话号码后4位
isBackTaskName string no 是否反馈任务名；非必传；默认no，如果需要反馈任务名请传yes
因为是POST方式，所以请求的时候，头部要带上Content-Type=application/x-www-form-urlencoded
入参是原生格式，不是json格式的

 

2、获取批量查询结果
用POST方式，发送请求到 http://yun.zhuzhufanli.com/mini/select/必须以斜杠结尾
参数名 类型 示例值 说明
appid* int 123 联系猪猪云客服配置
outerid* string(16) p4licpye1d2fr3fa 联系猪猪云客服配置
pageno* int 1 页码，从1开始
taskname* string J230823_223234938 任务名 
/*返回结果示例（josn格式）*/
{
  "code": 1,
  "msg": {
    "jindu": 100,/*进度=100时，下面的list数组才有值，也就是说任务查完后，才能反馈数据；一个任务多久能完成，没有确切时间，建议1-2分钟轮询一次该接口，当jindu=100时就表示任务完成了*/
    "totalpage": 3,/*总页数，每页100条数据*/
    "list": [
      {
        "kddh": "71263727633936",   /*这里每个字段的含义，跟上面一个接口是一样的，就不再赘述了*/
        "kdgs": "huitongkuaidi",
        "wuliuzhuangtai": "运输中",    /*物流状态（运输中、已签收、代收、无物流、疑似无物流、待查询、异常件 共7种，本站对于无物流单号会反复核查四遍，“疑似无物流”说明四遍尚未核完）*/
        "tiaoshu": 3,
        "fachushijian": "2017-11-21 00:46:42",
        "zuixinshijian": "2017-11-21 03:31:07",
        "zuihouwuliu": "2017-11-21 03:31:07 | 汕头市到件到汕头市【汕头转运中心】",
        "xiangxiwuliu": "/*太长省略*/",
        "chaxunshijian": "2017-11-21 15:46:31",
        "dingdanhao": "20180411114359001",   /*订单号*/
        "wwlyuanyin": "手机尾号不匹配" /*无物流原因*/
      }
    ]
  }
}

 

3、获取单个查询结果
用POST方式，发送请求到 http://yun.zhuzhufanli.com/mini/query/必须以斜杠结尾
提示：先用接口1创建任务后，才能利用此接口，调出来数据
参数名 类型 示例值 说明
kdgs* string shentong 快递公司代码，《详见表格》
kddh* string 123456789 单个快递单号 
/*返回结果示例*/
{
  "code": 1,
  "msg": {
    "kddh": "3338343295285",    /*快递单号*/
    "kdgs": "shentong", /*快递公司*/
    "wuliuzhuangtai": "运输中",    /*物流状态（运输中、已签收、代收、无物流、疑似无物流、待查询、异常件 共7种，本站对于无物流单号会反复核查四遍，“疑似无物流”说明四遍尚未核完）*/
    "tiaoshu": 12,  /*条数*/
    "fachushijian": "2017-09-12 14:49:05",  /*发出时间（即揽收时间）*/
    "zuixinshijian": "2017-09-15 21:55:44", /*最新时间*/
    "zuihouwuliu": "2017-09-15 21:55:44 | 您的快件已被许昌市莲城大道滨河名郡西门北侧【自提柜】代收，请及时取件。", /*最后一条物流信息*/
    "xiangxiwuliu": "太长省略。。。",  /*详细物流*/
    "chaxunshijian": "2017-09-16 10:54:25",  /*查询时间*/
    "dingdanhao": "20180411114359001",   /*订单号*/
    "wwlyuanyin": "手机尾号不匹配" /*无物流原因*/
  }
}

 

4、访问接口账户
在浏览器中打开该网址，可直接进入接口对应账户，http://yun.zhuzhufanli.com/mini/welcome/?appid=[appid]&outerid=[outerid]
提示：把[appid]和[outerid]替换成自己的
参数名 类型 示例值 说明
appid* int 12345 联系猪猪云客服配置
outerid* string(16) D53F6F1BB81F4A00 联系猪猪云客服配置

 

5、错误返回示例 
{
    "code":0,
    "msg":"抱歉！缺失必要参数"
}

 

6、成功返回示例 
{
    "code":1,
    "msg":"恭喜！任务创建成功"
}