Migration Guidance - QR Code Authorization V2

Overview

TikTok is making some changes to their developer products to improve privacy and security for developers and TikTok end users. As part of these changes, we are introducing an update to our QR code authorization (or Login Kit with QR code). If your apps do not integrate with QR code authorization, you do not need to perform the migration.

This guidance explains the necessary steps to complete this migration. Please note that if you do not complete the migration by 02/29/2024, your apps will not receive the correct response from QR code authorization APIs.

How to migrate

Step 1: Check QR code authorization usage

To determine if your apps need to perform the migration, check if you are using below APIs:

• GET: https://open-api.tiktok.com/v0/oauth/get_qrcode
• GET: https://open-api.tiktok.com/v0/oauth/check_qrcode

These two APIs will be deprecated by 02/29/2024. Once you confirm you need to perform the migration, go to Step 2 to complete the migration.

Step 2: Upgrade to v2 QR code authorization API

The following two APIs are provided to replace the previous ones:

• POST: https://open.tiktokapis.com/v2/oauth/get_qrcode/
• POST: https://open.tiktokapis.com/v2/oauth/check_qrcode/

Along with the API path, there are also some parameter changes in the new APIs. More detailed information about integrating the new APIs can be found here.

FAQs

Can I still use v1 QR code authorization?

If you are currently using the QR code authorization v1, you can use it until 02/29/2024. After 02/29/2024, only v2 QR code authorization will be supported. It is recommended that you perform the migration as soon as possible.