查询卖家地址库
通过此接口查询卖家地址库,
一、请求参数
请求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, 代表不同的应用,具体请咨询客服 |
二、请求示例代码
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);
}三、返回结果
{ "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会包含失败原因。