各位开发者:
随着业务发展,微信小店团队对小店类目相关的 API 进行升级,以更好地满足实际应用场景。(注意,此升级仅影响使用 API 的自研商家和第三方服务商,使用微信小店官网变更类目的商家不受影响。)
请开发者根据以下指引自查,如有涉及请按照推荐进行更改。
一、更新要点
此次升级的核心为:申请类目启用新的证照组要求,过渡期内兼容旧资质提交,过渡期后,将不再支持旧资质提交。
除此之外,团队还废弃和新增了一些 API,减少调用混乱,更好的满足开发者的业务需求。
1.废弃 API:以下 API 将不再维护,请开发者尽快切换。
- 获取可用的子类目详情:自 2025 年 9 月 30 日起下架,团队不再维护
- 获取账号申请通过的类目和资质信息:自 2025 年 9 月 30 日起下架,团队不再维护
- 获取审核结果 :自 2025 年 9 月 30 日起下架,团队不再维护
2.修改API:对 申请类目 API 做了协议修改,开发者应及时切换新的参数协议。
- 修改点:启用新资质(license_group_list)参数形式,同时废弃旧资质(certificate)参数形式。具体修改指引可参考 官方文档。
- 过渡期:即日起至 2025 年 9 月 30 日为过渡期,过渡期内兼容旧资质(certificate)提交,当 is_new_apply_cat 不存在或为 false 时,视为旧资质(certificate)提交,为true时,视为新资质(license_group_list)提交。
- 过渡结束:自2025 年 9 月 30 日起,将不支持旧资质(certificate)提交,无论 is_new_apply_cat 为何值,提交旧资质(certificate)都会出现报错,仅支持新资质(license_group_list)提交
API 请求参数修改示例:
// 旧形式-即将废弃
{
// ... 其他参数
"is_new_apply_cat": false, // 兼容期间,false 或者不存在时,接受 certificate
"certificate": [ "THE_FILE_ID_1" ]// 旧的资质证照列表,每一项为文件 ID
}
// 新形态
{
// ... 其他参数
"is_new_apply_cat": true, // 兼容期间,需设置为 true
"license_group_list": [{ // 新的资质证照列表
"license_group_id": "", // 证照组id
"license": {
"license_id": "", // 证照id
"file_id_list": ["THE_FILE_ID_1"],
"license_field_list": [{
"key": "",
"value": ""
}]
}
}]
}
不同的类目申请需要不同的资质,需先在 获取所有类目 中获取资质要求列表,然后对应上传,具体可查看 接口请求示例
3.新增 API:新增提供以下 API,更好支撑业务场景,开发者可按照自身情况适用。
二、类目 API 使用流程
以下是官方团队推荐的最新的 API 使用流程,请开发者根据自己实现的业务做对照,如有不符合应尽快切换。
第一步:获取类目信息
使用 获取所有类目 接口全量获取类目列表,以及其相关类目规则,此API返回包较大,建议开发者定时获取并缓存。
使用 获取类目信息 接口获取单个类目的相关信息,以及其相关类目规则。
第二步:申请类目
使用 申请类目 接口申请类目,适用新资质(license_group_list)参数形式提交。
第三步:类目审核
使用 获取店铺的类目审核单详情 接口,传入审核单 ID 查询审核单详情。
使用 获取店铺的类目审核单列表 接口可获取账号下审核单列表。
使用 撤销类目审核 接口,传入审核单 ID 可撤销审核。
使用 类目审核结果通知 可接收类目审核结果通知。
第四步:查询店铺类目权限
使用 获取店铺的类目权限列表 接口可查询账号下的类目权限列表。
使用 获取店铺的类目权限详情 接口可查询账号下的类目权限详情。
三、影响范围
本此升级仅影响使用 API 的自研商家和第三方服务商,不涉及客户端、基础库、开发者工具的适配改造。
注意:仅使用微信小店官网变更类目的商家不受影响。
四、升级通知
微信小店团队将在 2025 年 6 月 24 日- 9 月 30 日期间,对仍在使用旧协议和要废弃 API 的小店自研和第三方开发者发送「站内信」或「微信模板消息」通知,提醒及时适配更新。
2025 年 6 月 24 日
微信小店团队

内测