retailer/getAddressList
获取商家地址列表
URL
https://api.weibo.com/2/proxy/eshop/open/retailer/getAddressList
返回格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于电商服务商应用授权,参见 电商服务商应用 基础能力
访问授权限制
访问级别:高级接口(需要授权) - 仅限电商服务商第三方开发者
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
参数 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得,此参数放在GET请求中 |
appid | true | int | 电商服务商的身份标识,需联系微博电商分配获得 |
sign | true | string | 验证签名,签名算法见 电商服务商接口验证签名 |
注意事项
该接口不需要额外的参数,系统自动根据验签信息接口对应商家,返回对应数据,接口仅用来获取商家的地址列表,返回数据结构为数组
返回结果
JSON示例
{ "code": 0, "msg": "", "data": [ { "address_id": "181", "name": "收货人姓名", "phone": "14455555555", "region": "天津市-天津市-和平区", "address": "丽晶酒店", "is_def": "N" }, { "address_id": "180", "name": "收货人姓名2", "phone": "16634345345", "region": "北京市-北京市-东城区", "address": "我是详细地址,我是默认地址", "is_def": "Y" } ], "consume": 400, "time": 1700739784 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
code | int | 返回状态码,0-正常,其他为异常 |
address_id | string | 地址ID |
name | string | 收货人姓名 |
phone | string | 收货人手机号 |
region | string | 省市区,使用“-”分隔,直辖市省和市相同,如“北京市-北京市-东城区“ |
address | string | 详细地址 |
is_def | string | 是否默认地址,默认为“Y”,非默认为“N” |
其他
无
相关问题
无
文档更新时间: 2023-11-24