卖家地址库新增
通过此接口新增卖家地址库,卖家最多可添加5条地址库,新增第一条卖家地址,将会自动设为默认地址库 。
1.请求参数
请求URL:
POST https://kf.fw199.com/gateway/taobao/logistices/addr/add
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
| contact_name | string | 必填, 联系人姓名 长度不可超过20个字节 | |
| province | string | 必填, 所在省 | |
| city | string | 必填, 所在市 | |
| country | string | 可填,区、县如果所在地区是海外的可以为空,否则为必参 | |
| addr | string | 可填, 详细街道地址,不需要重复填写省/市/区 | |
| zip_code | string | 可填, 地区邮政编码如果所在地区是海外的可以为空,否则为必参 | |
| phone | string | 可填, 电话号码,手机与电话必需有一个 | |
| mobile_phone | string | 可填,手机号码,手机与电话必需有一个手机号码不能超过20位 | |
| seller_company | string | 可填, 公司名称,公司名称长能不能超过20字节 | |
| memo | string | 可填, 备注,备注不能超过256字节 | |
| get_def | Boolean | 可填,默认取货地址。选择此项(true),将当前地址设为默认取货地址,撤消原默认取货地址 | |
| cancel_def | Boolean | 可填,默认退货地址。选择此项(true),将当前地址设为默认退货地址,撤消原默认退货地址 |
2. 请求示例代码(Java)
@Test
public void LogisticsAddressAddRequest() 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("contact_name", "张三");
data.put("province", "上海");
data.put("city", "上海市");
data.put("country", "浦东新区");
data.put("addr", "世纪大道300号");
data.put("zip_code", "200120");
data.put("mobile_phone", "13877789900");
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoLogisticesAddrAddUrl ,data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"address_result": {
"modify_date": "2021-08-19 16:36:51" // 只返回修改日期modify_date
},
"request_id": "1036rkth9s7qb"
},
"trace_id": ""
}
说明: code为0表示成功,非0为失败, message会包含失败原因。
文档更新时间: 2023-03-14 16:35 作者:admin