# 获取关联的商家列表

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：get_ec_list

获取已关联/申请关联/已取消的商家列表。暂不提供解除商家关联的API，相关操作需登录供货商后台手动操作。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/supplier/relation/get_ec_list?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代供货商调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：192
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代供货商进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	说明
access_token	string	是	接口调用凭证，可使用 access_token（供货商）、authorizer_access_token（服务商代调用）

# 请求体 `Request Payload`

参数名	类型	必填	说明
offset	number	是	分页游标，起始位置
limit	number	是	分页数量
is_filter_type	boolean	否	是否开启状态筛选。默认为 false。若为 true，则 type 必填。
type	number	否	筛选类型，当 is_filter_type 为 true 时生效。枚举值： 1: 已关联 (FilterTypeBind) 2: 待审核 (FilterTypeAuditing) 3: 已取消/历史记录 (FilterTypeCancel)

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
list	objarray	商家列表
total_count	number	总数
errcode	number	错误码
errmsg	string	错误信息

# Res.list(Array) `Object Payload`

商家列表

参数名	类型	说明	枚举
appid	string	小店商家appid	-
name	string	商家店铺名称	-
status	number	关联状态	枚举值
bind_audit_status	number	关联状态详情	枚举值
update_time	number	更新时间	-
head_img	string	商家店铺头图	-

# 4. 枚举信息

# Res.list(Array).status `Enum`

关联状态

枚举值	描述
0	关联申请（待审核/已主动拒绝/超时自动拒绝，需结合bind_audit_status做详细判断）
1	已关联
2	已取消关联

# Res.list(Array).bind_audit_status `Enum`

关联状态详情

枚举值	描述
0	关联申请 - 待审核 (Auditing)
1	已关联 (Accept)
2	关联申请 - 已主动拒绝 (Reject)
3	关联申请 - 超时自动拒绝 (TimeoutReject)
5	已取消关联 (Init)

# 5. 注意事项

本接口无特殊注意事项

# 6. 代码示例

# 5.1 获取所有列表（默认）

请求示例

{
    "offset": 0,
    "limit": 10
}

返回示例

{
    "list": {
        "appid": "wx8888888",
        "name": "供货商test",
        "status": 1,
        "bind_audit_status": 1,
        "update_time": 1754386966,
        "head_img": "https://www.qq.com/1.png"
    },
    "total_count": 10,
    "errcode": 0,
    "errmsg": ""
}

# 5.2 筛选“待审核”的关联邀请

请求示例

{
    "offset": 0,
    "limit": 10,
    "is_filter_type": true,
    "type": 2
}

返回示例

{
    "list": {
        "appid": "wx8888888",
        "name": "供货商test",
        "status": 1,
        "bind_audit_status": 1,
        "update_time": 1754386966,
        "head_img": "https://www.qq.com/1.png"
    },
    "total_count": 10,
    "errcode": 0,
    "errmsg": ""
}

# 7. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述
268580000	参数错误

# 8. 适用范围

本接口支持「小店供货商」账号类型调用。其他账号类型如无特殊说明，均不可调用。

接口变更日志（1条）

2025 年 12 月 16 日

新增 is_filter_type 和 type 请求参数，支持筛选“待审核”、“已关联”或“已取消”状态的关联记录。