快递公司查询

---

接口地址： http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-companies-get

---

请求方式： POST

---

传参方式： JSON

---

返回格式： JSON

---

请求头参数

参数	类型	必选	值	示例
Authorization	string	是	授权 access_token	1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

参数	类型	必选	描述
shop_id	String	是	店铺 ID
params	Object	是	参数
fields	String[]	是	需返回的字段列表。可选值：LogisticCompany 结构中的所有字段;多个字段间用","逗号隔开。如：id,code,name,reg_mail_no 说明：id：物流公司 ID code：物流公司 code name：物流公司名称 reg_mail_no：物流公司对应的运单规则
is_recommended	Boolean	否	是否查询推荐物流公司。可选值：true,false.如果不提供此参数，将会返回所有支持电话联系的物流公司。
order_mode	string	否	推荐物流公司的下单方式。可选值：offline(电话联系/自己联系),online(在线下单),all(即电话联系又在线下单). 此参数仅仅用于 is_recommended 为 ture 时。就是说对于推荐物流公司才可用。如果不选择此参数将会返回推荐物流中支持电话联系的物流公司。
edition	string	否	版本 默认:1(不传默认为1) 1:1.0,2:2.0

请求示例

{
  "shop_id":173926031,
    "params":{
  "fields": "id,code,name,reg_mail_no",
  "is_recommended": true,
  "order_mode": "offline"
    }
}

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-companies-get' --header 'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx' --header 'Content-Type: application/json' --data-raw '{
  "fields": "id,code,name,reg_mail_no",
  "is_recommended": true,
  "order_mode": "offline"
}'

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-companies-get',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "fields": "id,code,name,reg_mail_no",
  "is_recommended": true,
  "order_mode": "offline"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: 1798c6aadec33d1bc2f5b707f1049aefexxxx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"fields\": \"id,code,name,reg_mail_no\",\r\n  \"is_recommended\": true,\r\n  \"order_mode\": \"offline\"\r\n}");
Request request = new Request.Builder()
  .url("http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-companies-get")
  .method("POST", body)
  .addHeader("Authorization", "1798c6aadec33d1bc2f5b707f1049aefexxxx")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

Pyton请求代码示例

import requests
import json

url = "http://www.damaijia168.com/vv/external/v1/requestTbErp/taobao-logistics-companies-get"

payload = json.dumps({
  "fields": "id,code,name,reg_mail_no",
  "is_recommended": True,
  "order_mode": "offline"
})
headers = {
  'Authorization': '1798c6aadec33d1bc2f5b707f1049aefexxxx',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

响应参数

参数	类型	描述
data	object	返回数据
----id	int	物流公司标识
----code	String	物流公司标识
----name	String	物流公司简称
----reg_mail_no	String	运单号验证正则表达式
----deduct_money	int	消耗点券
status	int	状态码，0为成功

返回数据

{
  "data": {
    "0":{
      "id": 44555,
      "code": "AB15555",
      "name": "********",
      "reg_mail_no": "^[0-9]{12}$"
    },
        "deduct_money": 4
  },
  "status": 0
}

错误码

状态码(status)	错误信息	解决方案
132	请求格式必须为JSON	修改请求参数格式为json
422	参数列表不合法，在err中会给出提示	根据提示做相应修改
200	认证失败	请确保请求头里的Authorization存在或者未过期