来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [CBSC] Significant OpenAPI Updates
尊敬的开发者，
请留意以下变动仅适用于CBSC店铺：
1.为进一步优化CBSC卖家从Open API获取全球商品可发布店铺列表的体验，我们提供了一个更加灵活的新接口v2.global_product.get_shop_publishable_status，通过返回店铺可发布状态来获取全球商品可发布的店铺列表。
响应体示例
2.对于老接口 v2.global_product.get_publishable_shop，新增非必填请求参数"shop_id_list"。
若传入"shop_id_list"将判断传入shop list是否可发布,同时返回支持发布的店铺列表;
若不传入"shop_id_list"字段, 在2024.02.01-2024.04.01，可获取到Merchant下所有可发布的店铺列表，在2024.04.01以后，只支持返回Merchant下前300个可发布店铺列表。
另，平台提供了2个月的迁移期以供各位开发者使用新接口v2.global_product.get_shop_publishable_status获取可发布的店铺列表，同时老接口v2.global_product.get_publishable_shop 的表现如下：
| 阶段 | 计划时间 | v2.global_product.get_publishable_shop 表现 |
|---|---|---|
| 迁移期 | 2024.02.01-2024.04.01 | 1.返回Merchant下所有可发布店铺列表 2.请求响应体包含warning字段："Please kindly note that start from 1 April, If the request not input any shop id, will only return the first 300 publishable shop list in the response" |
| 迁移后 | 2024.04.01及以后 | 返回Merchant下前300可发布店铺列表 |
影响接口：
v2.global_product.get_publishable_shop
v2.global_product.get_shop_publishable_status
生效日期：2024年2月1日
Dear Developer,
Please note the following changes which only Apply for CBSC sellers.
- To further improve the experience of CBSC sellers getting publishable shop list from the Open API, we are providing a more flexible new Open API: v2.global_product.get_shop_publishable_status, which is used to get the list of global product publishable shop list by return shop publishable status.
Sample of Response body
- For the former API v2.global_product.get_publishable_shop, add a new optional request parameter "shop_id_list",
if pass in "shop_id_list", it will determine whether the incoming shop list can be published or not and response only with the publishable shops.
if don't pass in "shop_id_list" field, can get the list of all publishable shops under Merchant from 2024.02.01-2024.04.01, but after 2024.04.01, it only supports returning the list of the first 300 publishable shops under Merchant.
In addition, the platform provides a 2-month migration period for developers to use the new v2.global_product.get_shop_publishable_status API to get the list of publishable shops, while the old v2.global_product.get_publishable_shop API behaves as follows:
| Phase | Plan Timeline | v2.global_product.get_publishable_shop Performance |
|---|---|---|
| Migration Period | 2024.02.01-2024.04.01 | 1.Response with all publishable shop ids under one merchant. 2.Response with warning field content is "Please kindly note that start from 1 April, If the request not input any shop id, will only return the first 300 publishable shop list in the response" |
| Post Migration | 2024.04.01and after | Return to the top 300 publishable shop ids under one merchant. |
Related APIs:
v2.global_product.get_publishable_shop
v2.global_product.get_shop_publishable_status
Effective date: 1 Feb 2024