全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取退货地址
接口地址: http://api.vv-tool.com/tool/erps/refund_address
接口介绍: 获取退货地址
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefeaaaa |
请求参数
参数 | 类型 | 必选 | 描述 |
---|---|---|---|
owner_id | string | 是 | 店铺 ID |
请求示例
{
"owner_id":"123465"
}
请求代码示例
cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/refund_address' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaaaa' --header 'Content-Type: application/json'--data-raw '{
"owner_id":"123465"
}'
PHP请求代码示例
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/refund_address',
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":"123465"
}',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaaaa',
'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 \"owner_id\":\"123465\"\r\n}");
Request request = new Request.Builder()
.url("http://api.vv-tool.com/tool/erps/refund_address")
.method("POST", body)
.addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefeaaaa")
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
响应参数
名称 | 类型 | 描述 |
---|---|---|
code | int | 返回状态码 |
msg | string | 返回码描述 |
msec | int | 接口执行时间 |
time | int | 接口返回时间 |
data | object | 数据信息 |
-content | array | 退货地址列表 |
--city_id | int | 退货地址所在城市 ID |
--city_name | string | 退货地址所在城市名字 |
--district_id | int | 退货地址所在区 ID |
--district_name | string | 退货地址所在区名字 |
--id | string | 退货地址 ID |
--is_default | string | 是否为默认退货地址 |
--is_legal | bool | 退货地址是否合法 |
--is_validated | bool | 退货地址是否有效 |
--mall_id | string | 店铺 ID 同 owner_id |
--province_id | int | 退货地址所在省份 ID |
--province_name | string | 退货地址所在省份名字 |
--refund_address | string | 退货地址 |
--refund_address_id | string | refund_id |
--refund_name | string | 退货收件人名字 |
--refund_phone | string | 退货收件人手机号 |
--refund_tel | string | 退货收件人固定电话 |
-withholding_money | int | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1148,
"time": 1630583653,
"data": {
"content": [
{
"is_legal": true,
"is_default": "Y",
"is_validated": true,
"refund_name": "王先生",
"province_name": "河南省",
"refund_phone": "YmQ4YzUzZGM0NDExNaaaaaaaaaaaajU2YjA2M2VhMTQzMTEyOTJjZmZlOTliMDZiN2UzNTU2Mjc2MaOhW1huS4eqPFj1fM7uvPM=",
"district_name": "中牟县",
"city_name": "郑州市",
"refund_address_id": "1_1_123456789",
"province_id": 11,
"mall_id": 123456789,
"refund_address": "中牟县九龙镇润之新物流园",
"district_id": 1267,
"id": 112647083,
"refund_tel": "",
"city_id": 149
}
],
"withholding_money": 1
}
}
响应代码
代码 | 代码描述 | 解决方案 |
---|---|---|
0 | 成功 | |
100 | 请求参数错误 | 检查您的请求参数是否正确 |
101 | 请求超时,请重试 | 检查您的网络情况或者联系客服解决 |
103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
200 | 系统错误,请联系客服 | 检查您的接口地址填写是否正确,其他问题联系客服解决 |
202 | 系统错误,请稍后再试 | 稍后重试,或者联系对接群 |
203 | 暂不支持当前接口 | |
204 | 请求异常:无该接口权限,请前往官网开通正式接口。 | 前往官网开通该接口权限 |
204 | 请求异常:API 调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
302 | 未授权店铺 | 根据返回链接进行扫码授权 |