接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：getaddresslist
可通过该接口获取地址列表
1. 调用方式
HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/merchant/address/list?access_token=ACCESS_TOKEN
云调用
-
调用方法：channels.ec.merchant.address.list
-
出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档。
第三方调用
-
本接口支持第三方平台代供货商调用。第三方服务商调用模式介绍
-
该接口所属的权限集 id 为：130、192
-
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代供货商进行调用，具体可查看 第三方调用 说明文档。
2. 请求参数
查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（供货商）、authorizer_access_token（服务商代调用） |
请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| offset | number | 是 | 获取的偏移量 |
| limit | number | 是 | 获取的个数 |
3. 返回参数
返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| address_id_list | array | 地址id列表 |
4. 注意事项
本接口无特殊注意事项
5. 代码示例
请求示例
{
"offset": 0,
"limit": 100
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"address_id_list": [
"111222",
"222333"
]
}
6. 错误码
此接口没有特殊错误码，可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
7. 适用范围
本接口在不同账号类型下的可调用情况：
| 微信小店 | 小店供货商 |
|---|---|
| ✔ | ✔ |
- ✔：该账号可调用此接口。
- 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。