查询物流公司信息

---

接口地址： http://api.vv-tool.com/tool/erps/companies

---

接口介绍： 批量查询物流订单，返回订单的物流信息状态详细信息 点击查看详情

---

请求方式： POST

---

返回格式： JSON

---

接口收费： 扣账户余额

---

频率限制： 10 次/秒

---

请求头参数

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

请求参数

参数	类型	必选	描述
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 时。就是说对于推荐物流公司才可用。如果不选择此参数将会返回推荐物流中支持电话联系的物流公司。
vvtype	int	否	普通版 1，不传默认 1，增强版 2，增强版的需要传参 2

请求示例

fields:id,code,name,reg_mail_no

请求代码示例

cURL请求代码示例

curl --location --request POST 'http://api.vv-tool.com/tool/erps/companies' \
--header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx' \
--header 'Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D' \
--form 'fields="id,code,name,reg_mail_no"'

PHP请求代码示例

<?php$curl = curl_init();curl_setopt_array($curl, array(CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/companies',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 => array('fields' => 'id,code,name,reg_mail_no'),CURLOPT_HTTPHEADER => array('Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx','Cookie: __yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D'),
));$response = curl_exec($curl);curl_close($curl);
echo $response;

JAVA请求代码示例

OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM).addFormDataPart("fields","id,code,name,reg_mail_no").build();
Request request = new Request.Builder().url("http://api.vv-tool.com/tool/erps/companies").method("POST", body).addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx").addHeader("Cookie", "__yjs_duid=1_dee3bfba5b90592372d209eda95c772a1616035269331; PHPSESSID=eg6rdq9svo8iisp0qdn8de28ds; _csrf=28d4b1b6a1a8187c94992e5c050d1d0c86b827c40735e28f2ae103584e094711a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%2252FhR6NNpbAyiE0zgVtqOXqPgIGWS7QY%22%3B%7D").build();
Response response = client.newCall(request).execute();

响应参数

参数	类型	描述
code	int	错误码 0 为成功
msg	string	返回码描述
msec	int	接口执行时间
time	int	接口返回时间
id	int	物流公司标识
code	String	物流公司标识
name	String	物流公司简称
reg_mail_no	String	运单号验证正则表达式
withholding_money	int	该接口扣费金额（点券）

返回数据

{"code": 0,"msg": "成功","msec": 1193,"time": 1612416107,"data":[{"withholding_money": 1,"id":44555,"code":"AB15555","name":"pingpaiming","reg_mail_no":"^[0-9]{12}$"}]}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
103	旺旺账号不存在	检查您输入的旺旺号是否正确
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确