来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [Important] Token Character Length Update & Open API and Push Mechanism Sunset
[Important] Token Character Length Update & Open API and Push Mechanism Sunset
Dear Developer, Please note the following updates:
-
For security reasons, we need to adjust the generation method of access_token and refresh_token, which will cause the character length of these two tokens to change. To avoid the impact of the character length update on your services, please change your storage type of access_token and refresh_token before 2024-09-30, if you use MySQL storage, please change to "text" type, and the solution for other databases are similar to MySQL. In addition, please complete this Acknowledge Survey before 2024-08-16 to confirm that you are aware of this update and required actions.
-
Please note the following Open API, Push Mechanism, Request/Response Parameters that will be sunset soon. To avoid affecting your services, if you are still using them, please switch to using the new Open API, Push Mechanism, Request/Response Parameters before the corresponding sunset date.
- Please note the following Open API and Push Mechanism that will be sunset soon:
| Sunset API/Push | Sunset Date | New API/Push |
|---|---|---|
| banned_item_push | 2024-09-30 | violation_item_push |
| v2.public.get_refresh_token_by_upgrade_code | 2024-09-30 | / (As all existing authorized sellers have migrated from Open API v1.0 to Open API v2.0, this Open API is no longer supported.) |
| v2.account_health.shop_performance | 2024-09-30 | v2.account_health.get_shop_performance |
| v2.product.get_dts_limit | 2024-09-30 | v2.product.get_item_limit |
| v2.global_product.get_dts_limit | 2024-09-30 | v2.global_product.get_global_item_limit |
| v2.product.get_attributes | 2024-10-31 | v2.product.get_attribute_tree |
| v2.global_product.get_attributes | 2024-10-31 | v2.global_product.get_attribute_tree |
- Please note the following Request/Response Parameters that will be sunset soon:
| Related API | Location | Sunset Param | Sunset Date | New Param |
|---|---|---|---|---|
| v2.shop.get_shop_info | Response | is_3pf | 2024-09-30 | shop_fulfillment_flag |
| v2.shop.get_shop_info | Response | is_cnsc shop_cbsc | 2024-09-30 | is_upgraded_cbsc merchant_id |
| v2.merchant.get_merchant_info | Response | is_cnsc | 2024-09-30 | is_upgraded_cbsc merchant_region |
| v2.merchant.get_shop_list_by_merchant | Response | is_cnsc shop_is_cnsc | 2024-09-30 | Can get the shop detailed info by calling v2.shop.get_shop_info |
| v2.global_product.add_global_item | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.global_product.init_tier_variation | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.global_product.add_global_model | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.global_product.update_stock | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.product.add_item | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.product.add_item | Response | stock_info | 2024-09-30 | seller_stock |
| v2.product.get_item_base_info | Response | stock_info | 2024-09-30 | stock_info_v2 |
| v2.product.get_item_promotion | Response | reserved_stock_info | 2024-09-30 | promotion_stock_info_v2 |
3.Please note that the requirements for cross-border order customized waybill for CNSC orders have been updated:
-
Please add the site abbreviation in the red box area shown in the picture below.
-
Site abbreviations: MY, ID, TH, PH, SG, VN, BR, MX, CO, CL, TW. You may print according to the actual site of the order.
尊敬的开发者,
请留意以下变动:
-
出于安全需要,我们需要调整access_token与refresh_token的生成方式,这将导致access_token与refresh_token的字符长度发生改变。 为了避免access_token与refresh_token字符长度更新对您的服务造成影响,请您在2024-09-30之前更改您的access_token与refresh_token的存储类型,如果您使用MySQL存储,请更改为"text"类型,其他数据库的解决方案与MySQL类似。 另外,请在2024-08-16之前完成此Acknowledge Survey,以确认您已了解此更新以及需要采取的措施。
-
请注意,以下Open API, Push Mechanism, Request/Response Parameters即将下线,为了避免影响您的服务,若您仍然在使用,请在对应的下线日期之前切换对接新的Open API, Push Mechanism, Request/Response Parameters。
- 以下Open API, Push Mechanism, Request/Response Parameters即将下线:
| Sunset API/Push | Sunset Date | New API/Push |
|---|---|---|
| banned_item_push | 2024-09-30 | violation_item_push |
| v2.public.get_refresh_token_by_upgrade_code | 2024-09-30 | / (由于所有存量的授权卖家已完成从Open API v1.0切换至 Open API v2.0,因此不再支持该接口) |
| v2.account_health.shop_performance | 2024-09-30 | v2.account_health.get_shop_performance |
| v2.product.get_dts_limit | 2024-09-30 | v2.product.get_item_limit |
| v2.global_product.get_dts_limit | 2024-09-30 | v2.global_product.get_global_item_limit |
| v2.product.get_attributes | 2024-10-31 | v2.product.get_attribute_tree |
| v2.global_product.get_attributes | 2024-10-31 | v2.global_product.get_attribute_tree |
- 以下Request/Response Parameters即将下线:
| Related API | Location | Sunset Param | Sunset Date | New Param |
|---|---|---|---|---|
| v2.shop.get_shop_info | Response | is_3pf | 2024-09-30 | shop_fulfillment_flag |
| v2.shop.get_shop_info | Response | is_cnsc shop_cbsc | 2024-09-30 | is_upgraded_cbsc merchant_id |
| v2.merchant.get_merchant_info | Response | is_cnsc | 2024-09-30 | is_upgraded_cbsc merchant_region |
| v2.merchant.get_shop_list_by_merchant | Response | is_cnsc shop_is_cnsc | 2024-09-30 | 可以调用 v2.shop.get_shop_info 获取Shop详细信息 |
| v2.global_product.add_global_item | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.global_product.init_tier_variation | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.global_product.add_global_model | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.global_product.update_stock | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.product.add_item | Request | normal_stock | 2024-09-30 | seller_stock |
| v2.product.add_item | Response | stock_info | 2024-09-30 | seller_stock |
| v2.product.get_item_base_info | Response | stock_info | 2024-09-30 | stock_info_v2 |
| v2.product.get_item_promotion | Response | reserved_stock_info | 2024-09-30 | promotion_stock_info_v2 |
- 请注意,CNSC跨境订单包裹自画面单要求更新:
-
在下图红框位置,增加站点缩写标识。
-
站点缩写:MY, ID, TH, PH, SG, VN ,BR, MX, CO, CL, TW,请根据订单实际所属站点进行打印。
