# 获取供货商列表
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:get_supplier_list
本接口用于获取已关联的供货商列表。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/supplier/relation/get_supplier_list?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为:131
服务商获得其中之一权限集授权后,可通过使用 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
| 参数名 | 类型 | 说明 |
|---|---|---|
| list | objarray | 供货商列表 |
| total_count | number | 列表总数 |
| errcode | number | 错误码 |
| errmsg | string | 错误描述 |
# Res.list(Array) Object Payload
供货商列表
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| name | string | 供货商名称 | - |
| appid | string | 供货商appid | - |
| status | number | 状态 | 枚举值 |
| bind_audit_status | number | 绑定审核状态 | 枚举值 |
| update_time | number | 更新时间 | - |
# 4. 枚举信息
# Res.list(Array).status Enum
状态
| 枚举值 | 描述 |
|---|---|
| 0 | 初始状态 |
| 1 | 已绑定 |
| 2 | 已解绑 |
# Res.list(Array).bind_audit_status Enum
绑定审核状态
| 枚举值 | 描述 |
|---|---|
| 0 | 待审核 |
| 1 | 已接受 |
| 2 | 已拒绝 |
| 3 | 超时自动拒绝 |
| 4 | 小店自行取消 |
| 5 | 初始状态 |
# 5. 注意事项
本接口无特殊注意事项
# 6. 代码示例
请求示例
{
"offset": 0,
"limit": 0
}
返回示例
{
"list": {
"name": "",
"appid": "",
"status": 0,
"bind_audit_status": 0,
"update_time": 0
},
"total_count": 0,
"errcode": 0,
"errmsg": ""
}
# 7. 错误码
此接口没有特殊错误码,可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
# 8. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。