V兔API开放平台

参数	类型	必选	描述
rdef	String	否	可选，参数列表如下： no_def:查询非默认地址 get_def:查询默认取货地址，也即对应卖家后台地址库中发货地址（send_def 暂不起作用） cancel_def:查询默认退货地址缺省此参数时，查询所有当前用户的地址库
vvtype	int	否	普通版 1，不传默认 1，增强版 2，增强版的需要传参 2，标准版 3,需要标准版的传 3

请求示例


{
	"rdef": "get_def",
	"vvtype": "1"
}

请求代码示例

cURL请求代码示例

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "http://api.vv-tool.com/tool/erps/searchaddress");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "content-type: multipart/form-data; boundary=---011000010111000001101001");
headers = curl_slist_append(headers, "Authorization: Bearer XXXXXXXXXXXXXXXXXXX");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"rdef\"\r\n\r\nget_def\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"vvtype\"\r\n\r\n1\r\n-----011000010111000001101001--\r\n\r\n");

CURLcode ret = curl_easy_perform(hnd);

PHP请求代码示例

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://api.vv-tool.com/tool/erps/searchaddress",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"rdef\"\r\n\r\nget_def\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"vvtype\"\r\n\r\n1\r\n-----011000010111000001101001--\r\n\r\n",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer XXXXXXXXXXXXXXXXXXX",
    "content-type: multipart/form-data; boundary=---011000010111000001101001"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

JAVA请求代码示例

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("multipart/form-data; boundary=---011000010111000001101001");
RequestBody body = RequestBody.create(mediaType, "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"rdef\"\r\n\r\nget_def\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"vvtype\"\r\n\r\n1\r\n-----011000010111000001101001--\r\n\r\n");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/searchaddress")
  .post(body)
  .addHeader("content-type", "multipart/form-data; boundary=---011000010111000001101001")
  .addHeader("Authorization", "Bearer XXXXXXXXXXXXXXXXXXX")
  .build();

Response response = client.newCall(request).execute();

响应参数

名称	类型	示例值	描述
addresses	AddressResult []		一组地址库数据，
--contact_id	Number	123456	地址库 ID
--contact_name	String	姓名	联系人姓名
--province	String	浙江省	省
--city	String	杭州市	市
--country	String	西湖区	区、县
--addr	String	华星路 xx 号	详细街道地址，不需要重复填写省/市/区
--zip_code	String	315040	地区邮政编码
--phone	String	-****-	电话号码，手机与电话必需有一个
--mobile_phone	String	136*********	手机号码，手机与电话必需有一个手机号码不能超过 20 位
--seller_company	String	公司名称	公司名称，
--memo	String	备注	备注
--area_id	Number	132456	区域 ID
--send_def	Boolean	true	是否默认发货地址
--get_def	Boolean	true	是否默认取货地址
--cancel_def	Boolean	true	是否默认退货地址
--modify_date	Date	2000-01-01 00:00:00	修改日期时间
withholding_money	int	1	该接口扣费金额（点券）

返回数据

{"code": 0, "msg": "操作成功", "msec": 1469, "time": 1617270403, "data": {"logistics_address_search_response": {"addresses": {"address_result": [{"contact_id": 123456, "contact_name": "姓名", "province": "浙江省", "city": "杭州市", "country": "西湖区", "addr": "华星路xx号", "zip_code": "315040", "phone": "****-********-****", "mobile_phone": "136*********", "seller_company": "公司名称", "memo": "备注", "area_id": 132456, "send_def": true, "get_def": true, "cancel_def": true, "modify_date": "2000-01-01 00:00:00"}]}}}}

响应代码

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

查询卖家地址库

请求头参数

请使用新的生成 token 接口 点击查看详情

请求参数

请求示例

请求代码示例

响应参数

返回数据

响应代码

请使用新的生成 token 接口点击查看详情