跳转到: 导航, 搜索

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
api评价