接口地址: http://api.vv-tool.com/tool/erps/companies
接口介绍: 批量查询物流订单,返回订单的物流信息状态详细信息 点击查看详情
请求方式: POST
返回格式: JSON
接口收费: 详询: v:vtupaofu8888, 扣账户余额
频率限制: 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 | 请求路径或请求方式错误 | 请更换请求方式或者检查路径是否正确 |
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!