收藏
评论

微信小店类目相关 API 升级官方

各位开发者:


随着业务发展,微信小店团队对小店类目相关的 API 进行升级,以更好地满足实际应用场景。(注意,此升级仅影响使用 API 的自研商家和第三方服务商,使用微信小店官网变更类目的商家不受影响。)


请开发者根据以下指引自查,如有涉及请按照推荐进行更改。



一、更新要点


此次升级的核心为:申请类目启用新的证照组要求,过渡期内兼容旧资质提交,过渡期后,将不再支持旧资质提交。

除此之外,团队还废弃和新增了一些 API,减少调用混乱,更好的满足开发者的业务需求。


1.废弃 API:以下 API 将不再维护,请开发者尽快切换。



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 日

微信小店团队






7323浏览
最后一次编辑于  06-24
收藏

1 个评论

登录 后发表内容