来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [Important] About Ending Maintenance for Sandbox and Upgrading to Sandbox V2
Dear Developers,
To improve the long-term testing experience in the Sandbox environment (hereinafter referred to as V1), we have created a new sandbox called Sandbox V2 (hereinafter referred to as V2). During the testing phase, V2 operates under a whitelist system, accessible only to selected developers, to gradually verify its stability and compatibility. Current evaluations show that Sandbox V2 greatly exceeds V1 in stability, maintainability, and performance. It better supports developers testing core scenarios such as product management, order management, and logistics fulfillment. As a result, we have decided to open Sandbox V2 to all developers.
Key changes to note after the upgrade:
Data in the V1 sandbox cannot be transferred to the new sandbox. After upgrading, all data in the V1 sandbox will be lost. Please note:
- Data in the sandbox v1 will be fully deleted.
- Recreate test accounts, products, and orders in the new V2 sandbox.
- Update your Test Partner ID and Test Partner Key. The Request URL for the V2 Sandbox API will also be updated.
For detailed operational steps, please consult our test guide documentation: https://open.shopee.com/developer-guide/644. We plan to perform this switch on September 15th, when you will be able to use our new sandbox version in the OP console. Below is an overview of the changes in Sandbox V2.
Sandbox V2 Update Log:
| Surroundings | Sandbox V1 | Sandbox V2 |
|---|---|---|
| Test URL | https://partner.test-stable.shopeemobile.com | https://openplatform.sandbox.test-stable.shopee.sg |
| Test URL(Chinese Mainland) | https://partner.test-stable.shopeemobile.cn | https://openplatform.sandbox.test-stable.shopee.cn |
Sandbox V2 Support Scope:
| Portal | Modules | Features | Remark |
|---|---|---|---|
| Console | Shop | Create test shop account | |
| Console | Order | Create test order | |
| Console | Push | Push test data | |
| Seller Center | Product | Create and manage the global SKU | |
| Seller Center | Product | Publish and manage the shop SKU | |
| Seller Center | Order | Order | |
| Seller Center | Order | Ship Order | Printing AWB in Seller Center is not currently supported. Please use the Open API for printing. |
| Open API | Product | All APIs | Can Be Called via the API Test Tools in the Console You can also call it yourself using the Regions: https://openplatform.sandbox.test-stable.shopee.sg/. Chinese Mainland: https://openplatform.sandbox.test-stable.shopee.cn/. |
| Open API | Global Product | All APIs | |
| Open API | Media Space | All APIs | |
| Open API | Order | All APIs | |
| Open API | Logistics | All APIs | |
| Open API | First Mile | All APIs | |
| Open API | Shop | All APIs | |
| Open API | Merchant | All APIs | |
| Push | Supports receiving partial push test data. For details, refer to the Sandbox Push Mechanism Support Scope. |
(If you need additional features supported by the sandbox, please submit a support ticket with your specific use case and requirements.)
Sandbox Push Mechanism Support Scope:
| Push Category | Push Mechanism | Push Code |
|---|---|---|
| Product Push | banned_item_push | 6 |
| Product Push | reserved_stock_change_push | 8 |
| Product Push | video_upload_push | 11 |
| Product Push | brand_register_result | 13 |
| Product Push | violation_item_push | 16 |
| Product Push | shopee_auto_correct_item_push | 17 |
| Product Push | item_price_update_push | 22 |
| Product Push | item_scheduled_publish_failed_push | 27 |
| Order Push | order_trackingno_push | 4 |
| Order Push | order_status_push | 3 |
| Order Push | shipping_document_status_push | 15 |
| Order Push | booking_status_push | 23 |
| Order Push | booking_trackingno_push | 24 |
| Order Push | booking_shipping_document_status_push | 25 |
| Order Push | package_fulfillment_status_push | 30 |
| Order Push | courier_delivery_binding_status_push | 37 |
| Marketing Push | promotion_update_push | 9 |
| Marketing Push | item_promotion_push | 7 |
| Shopee Push | shop_authorization_push | 1 |
| Shopee Push | shop_authorization_push | 2 |
| Shopee Push | shopee_updates | 5 |
| Shopee Push | shop_penalty_update_push | 28 |
| Webchat Push | webchat_push | 10 |
| Return Push | return_updates_push | 29 |
| Fulfillment by Shopee Push | fbs_sellable_stock | 36 |
| Fulfillment by Shopee Push | fbs_br_invoice_error_push | 33 |
| Fulfillment by Shopee Push | fbs_br_block_shop_push | 34 |
| Fulfillment by Shopee Push | fbs_br_block_sku_push | 35 |
| Fulfillment by Shopee Push | fbs_br_invoice_issued_push | 31 |
| Fulfillment by Shopee Push | fbs_br_shop_enrollment_status_push | 32 |
Note: Some modules are unavailable in the sandbox, so you can only test the push message.
If you encounter sandbox issues, please submit a Ticket for assistance.
尊敬的开发者,
为提升Sandbox(以下称 V1)环境的测试长期体验,我们构建了一个新的沙箱环境 Sandbox V2(以下称V2)。在测试阶段,V2 环境采取白名单机制,仅向部分开发者开放,以便逐步验证其稳定性与兼容性。当前已经验证 Sandbox V2 在稳定性,可维护性和性能方面均显著优于 V1。可以更好的支持开发者测试核心心场景,例如:商品管理、订单管理、物流发货等,因此我们决定全量开放Sandbox V2。
升级后需注意的主要变化:
V1沙箱中的数据无法与新沙箱互通,升级后V1沙箱数据均不会保留,您需要注意:
- 旧沙箱中的数据将被完全删除。
- 在V2新沙箱内重新创建测试账号、商品和订单。
- 更新您的 Test partner ID 和Test Partner Key ,V2 Sandbox API的 Request URL也会更新。
具体操作步骤请参考我们的测试指引文档:https://open.shopee.com/developer-guide/644
我们计划在9月15日进行本次切换,届时您将可以在OP console中体验我们的新版沙箱。以下为Sandbox V2 变化简介:
Sandbox V2 变更内容
| Surroundings | Sandbox V1 | Sandbox V2 |
|---|---|---|
| Test URL | https://partner.test-stable.shopeemobile.com | https://openplatform.sandbox.test-stable.shopee.sg |
| Test URL(Chinese Mainland) | https://partner.test-stable.shopeemobile.cn | https://openplatform.sandbox.test-stable.shopee.cn |
Sandbox V2支持范围:
| Portal | Modules | Features | Remark |
|---|---|---|---|
| Console | Shop | Create test shop account | |
| Console | Order | Create test order | |
| Console | Push | Push test data | |
| Seller Center | Product | Create and manage the global SKU | |
| Seller Center | Product | Publish and manage the shop SKU | |
| Seller Center | Order | Order | |
| Seller Center | Order | Ship Order | 暂不支持卖家中心打印面单 请使用Open API打印 |
| Open API | Product | All APIs | 通过Console中API Test Tools进行调用。 或使用以下连接调用: Regions: https://openplatform.sandbox.test-stable.shopee.sg/ 用。 Chinese Mainland: https://openplatform.sandbox.test-stable.shopee.cn/ |
| Open API | Global Product | All APIs | |
| Open API | Media Space | All APIs | |
| Open API | Order | All APIs | |
| Open API | Logistics | All APIs | |
| Open API | First Mile | All APIs | |
| Open API | Shop | All APIs | |
| Open API | Merchant | All APIs | |
| Push | 支持接收部分push测试数据 具体见Sndbox Push Mechanism支持范围 |
(如果有更多需要沙箱支持的功能,请提工单反馈您的具体使用场景和诉求)
Sndbox Push Mechanism支持范围:
| Push Category | Push Mechanism | Push Code |
|---|---|---|
| Product Push | banned_item_push | 6 |
| Product Push | reserved_stock_change_push | 8 |
| Product Push | video_upload_push | 11 |
| Product Push | brand_register_result | 13 |
| Product Push | violation_item_push | 16 |
| Product Push | shopee_auto_correct_item_push | 17 |
| Product Push | item_price_update_push | 22 |
| Product Push | item_scheduled_publish_failed_push | 27 |
| Order Push | order_trackingno_push | 4 |
| Order Push | order_status_push | 3 |
| Order Push | shipping_document_status_push | 15 |
| Order Push | booking_status_push | 23 |
| Order Push | booking_trackingno_push | 24 |
| Order Push | booking_shipping_document_status_push | 25 |
| Order Push | package_fulfillment_status_push | 30 |
| Order Push | courier_delivery_binding_status_push | 37 |
| Marketing Push | promotion_update_push | 9 |
| Marketing Push | item_promotion_push | 7 |
| Shopee Push | shop_authorization_push | 1 |
| Shopee Push | shop_authorization_canceled_push | 2 |
| Shopee Push | shopee_updates | 5 |
| Shopee Push | shop_penalty_update_push | 28 |
| Webchat Push | webchat_push | 10 |
| Return Push | return_updates_push | 29 |
| Fulfillment by Shopee Push | fbs_sellable_stock | 36 |
| Fulfillment by Shopee Push | fbs_br_invoice_error_push | 33 |
| Fulfillment by Shopee Push | fbs_br_block_shop_push | 34 |
| Fulfillment by Shopee Push | fbs_br_block_sku_push | 35 |
| Fulfillment by Shopee Push | fbs_br_invoice_issued_push | 31 |
| Fulfillment by Shopee Push | fbs_br_shop_enrollment_status_push | 32 |
Note: 部分模块还没有再沙箱开放,因此你只可以测试test push message。
如果您在沙箱的使用中遇到任何的问题,可以麻烦你通过 工单 获取支持。
