全部
淘宝
拼多多
抖音
京东
快手
当当
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 未授权店铺 根据返回链接进行扫码授权