[Update] [Important] Open API 1.0 Deprecation Plan

Dear Developers

Following our announcements of updates to the Open Platform policies on 11 May 2022 on the [Important] Open API 1.0 Deprecation Plan (Phase 1 Open API will be deprecated on 11 August 2022), Shopee will begin deprecating the remaining Open API 1.0 in the next two phases:

1. Phase 2 Open APIs will be deprecated on 31 October 2022

2. Phase 3 Open APIs will be deprecated on 26 December 2022

Action required

1. Complete the acknowledgment survey by 29 August 2022, or your APP(s) will no longer be able to access the below Phase 2 and Phase 3 Open API 1.0 from 30 August 2022 onwards.

2. Review the attached list of Phase 2 and Phase 3 APIs and complete your migration before the APIs are deprecated.

FAQs

1. Do I need to integrate Open API 2.0 Authorization with my APP(s) before migrating my APIs?

Yes, integration of Open API 2.0 Authorization with my APP(s) is necessary before migrating your APIs. Refer to Open API 2.0 Overview for the new authorization and authentication instructions.

2. Do I need to create a new APP to integrate with Open API 2.0?

No, you do not need to. Also, note that APP(s) created after 28 March 2022 can only call Open API 2.0.

3. How do I transfer existing seller authorizations from Open API 1.0 to Open API 2.0?

Here are 2 methods to transfer existing seller authorizations to Open API 2.0:

Method 1

i) Get the upgrade_code. You may refer to the announcement to learn how.

ii) Call the v2.public.get_refresh_token_by_upgrade_code to get existing shops’ refresh_token from sellers who have granted authorization.

Method 2

Get sellers’ refresh_token and access_token through the usual shop authorization process.

4. If I lose the access_token or the refresh_token after migrating to Open API 2.0, how do I get a new valid token?

Here are 2 methods to get a new valid token:

Method 1

You can call the v2.public.get_token_by_resend_code to get a new valid refresh_token and access_token. Refer to this FAQ on resending code on the Shopee Open Platform for more information.

Method 2

Get sellers’ refresh_token and access_token through the usual shop authorization process.

尊敬的开发者

关于Open API 1.0下线计划更新（第一批下线接口将从2022年8月11日下线），Shopee将对剩余1.0接口分两个批下线：

1. 第二批下线时间为2022年10月31日

2. 第三批下线时间为2022年12月26日

接下来：

1. 开发者需要在2022年8月29日之前完成第二批及第三批下线公告的知晓，否则从2022年8月30日起将无法调用以下第二批以及第三批Open API 1.0接口

2. 查看第二批以及第三批1.0接口下线列表，并且于下线之前完成对应接口的迁移工作。

FAQ：

1. 在接口切换至OpenAPI 2.0的过程中是否需要先对接 2.0的授权？

- 是的，需要先对接OpenAPI 2.0授权，详情请参考OpenAPI 2.0 Overview授权与鉴权

2. 我是否需要创建新的App对接OpenAPI 2.0？

- 不需要。此外，自2022-03-28后创建的app仅能调用OpenAPI 2.0

3如何将存量的授权卖家从1.0的授权迁移到2.0？

- 方法一：拿到 upgrade_code， 并通过upgrade_code调用v2.public.get_refresh_token_by_upgrade_code获取存量店铺的refresh_token

- 方法二：通过OpenAPI 2.0的正常授权流程

4. 将卖家授权迁移至2.0后，在使用的过程中如果token丢失，如何拿到新的可用token？

- 方法一：可以通过调用v2.public.get_token_by_resend_code拿到一组新的refresh_token与access_token，可参考FAQ

- 方法二：通过OpenAPI 2.0的正常流程重新授权

Attachment：

Offline List of Open API 1.0 Phase 2

Offline List of Open API 1.0 Phase 3