全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

获取网点信息


接口地址: http://api.vv-tool.com/tool/erps/ks-network-info


接口介绍: 获取网点信息


必须用户授权 : 需要用户的授权,才能拿到被授权的数据点击查看详情


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefeaaaa

请求参数

参数 类型 必选 描述
owner_id string 店铺 ID
wp_code string 快递编号,比如:SF,STO
platform string 授权渠道
1 拼多多站外电子面单
2 淘宝菜鸟电子面单
3 菜鸟物流云电子面单(目前只能选 1)
vvtype int

请求示例

{
"owner_id":"123465"
}

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/get-network-info' --header 'Authorization: Bearer 238dac98e3e5d25373783336c0bbbb943389b69c' --header 'Content-Type: application/json' --header 'Cookie: PHPSESSID=3gpdn2tfe6mdbm40k6dkq9c5kl; _csrf=eaee5db28d14fe6c21b021e617d4c9482a33bc3edbb1c39393b5572964f6de37a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22vchjSxdagX52QDyExOdAk25yN8k0pJU7%22%3B%7D' --data-raw '{
    "owner_id":"123456789"
}'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/get-network-info',
  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 =>'{
    "owner_id":"123456789"
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 238dac98e3e5d25373783336c0bbbb943389b69c',
    'Content-Type: application/json',
    'Cookie: PHPSESSID=3gpdn2tfe6mdbm40k6dkq9c5kl; _csrf=eaee5db28d14fe6c21b021e617d4c9482a33bc3edbb1c39393b5572964f6de37a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22vchjSxdagX52QDyExOdAk25yN8k0pJU7%22%3B%7D'
  ),
));

$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    \"owner_id\":\"123456789\"\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/get-network-info")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 238dac98e3e5d25373783336c0bbbb943389b69c")
  .addHeader("Content-Type", "application/json")
  .addHeader("Cookie", "PHPSESSID=3gpdn2tfe6mdbm40k6dkq9c5kl; _csrf=eaee5db28d14fe6c21b021e617d4c9482a33bc3edbb1c39393b5572964f6de37a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22vchjSxdagX52QDyExOdAk25yN8k0pJU7%22%3B%7D")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 描述
code int 返回状态码
msg string 返回码描述
msec int 接口执行时间
time int 接口返回时间
data object 数据信息
-branch_account_cols array wp 网点信息及对应的商家的发货信息
--allocated_quantity long 已用面单数量
--branch_code string 网点 Code
--branch_name string 网点名称
--cancel_quantity long 取消的面单总数
--quantity long 电子面单余额数量
--recycled_quantity long 已回收用面单数量
--service_info_cols array 服务类型列表
---required bool 是否必须
---service_attributes array 服务属性类型列表
----attribute_code string 属性 code
----attribute_name string 属性名称
----attribute_type string 属性类型
----type_desc string 属性描述
---service_code string 服务 code
---service_desc string 服务描述
---service_name string 服务名称
--shipp_address_cols array 当前网点下的发货地址
---city string 市名称(二级地址)
---detail string 详细地址
---district string 区名称(三级地址)
---province string 省名称(一级地址)
---country string 国家/地区
--vas_account_cols array 增值服务账号
---account_type_desc string 账户类型描述
---quantity long 电子面单余额数量
---allocated_quantity long 已用面单数量
---cancel_quantity long 取消的面单总数
---recycled_quantity long 已回收用面单数量
-wp_code string 快递公司 ID
-wp_type int 物流服务商业务类型
-withholding_money int 该接口扣费金额(点券)

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1020,
    "time": 1630586024,
    "data": {
        "content": [
            {
                "wp_type": 1,
                "branch_account_cols": [
                    {
                        "branch_code": "450584",
                        "quantity": 15,
                        "branch_name": "湖南大客户部星辰服务部",
                        "cancel_quantity": 32,
                        "shipp_address_cols": [
                            {
                                "country": "中国",
                                "province": "湖南省",
                                "city": "长沙市",
                                "district": "岳麓区",
                                "detail": "物流园"
                            }
                        ],
                        "recycled_quantity": 0,
                        "allocated_quantity": 85
                    }
                ],
                "wp_code": "YUNDA"
            }
        ],
        "withholding_money": 1
    }
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或者联系对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权