查询卖家地址库

通过此接口查询卖家地址库,

1.请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/logistices/addr/search

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
sign String 接口签名 如何计算生成见示例代码
rdef string 可选,参数列表如下:no_def:查询非默认地址,get_def:查询默认取货地址,也即对应卖家后台地址库中发货地址(send_def暂不起作用)cancel_def:查询默认退货地址 缺省此参数时,查询所有当前用户的地址库
sysid String 100,101,102 可空,默认100, 代表不同的应用,具体请咨询客服

2. 请求示例代码(Java)

    @Test
    public void  LogisticsAddressSearchRequest() throws Exception { 
        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("tb_seller_nick", tb_seller_nick);
        data.put("rdef", "");
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoLogisticesAddrSearchUrl ,data);

    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": {
        "addresses": {
            "address_result": [{
                "addr": "九天国际三座1917室", // 详细街道地址,不需要重复填写省/市/区
                "area_id": 430203, // 区域ID 
                "cancel_def": false, // 是否默认退货地址 
                "city": "株洲市", // 市
                "contact_id": 18267569,   //地址库ID 
                "contact_name": "赵海森",// 联系人姓名
                "country": "芦淞区", // 区、县
                "get_def": false, // 是否默认取货地址
                "mobile_phone": "13787836332", // 手机号码,手机与电话必需有一个手机号码不能超过20位
                "modify_date": "2020-11-03 10:23:24", // 修改日期时间
                "province": "湖南省", // 省
                "seller_company": "株洲配送中心", // 公司名称,
                "send_def": false, // 是否默认发货地址
                "zip_code": "412000" // 地区邮政编码
            }, {
                "addr": "东方路320号1号楼F9",
                "area_id": 310115,
                "cancel_def": false,
                "city": "上海市",
                "contact_id": 18701489,
                "contact_name": "刘大寻",
                "country": "浦东新区",
                "get_def": false,
                "modify_date": "2011-11-23 09:13:06",
                "phone": "021-50258325",
                "province": "上海",
                "seller_company": "上海多多网络科技",
                "send_def": false,
                "zip_code": "201204"
            } ]
        },
        "request_id": "eg0lt3x1yosn"
    },
    "trace_id": ""
}

说明: code为0表示成功,非0为失败, message会包含失败原因。

文档更新时间: 2024-01-02 18:59   作者:admin