tiktok_api

Description:

tiktok api

tiktok_api #
The tiktok_api project develops open-source Flutter plugin library to integrate with Tiktok's APIs. This project
provides the painless way to integrate with Tiktok since following Tiktok's documentation
and support, in our experience, will not work.
This project is free but you can
Features #

(WIP) integration for Android
(alpha) integration for iOS
(planned) integration for web

Requirements #

Flutter version 3.x.x
Dart version 3.x.x
A web server to store the App Link (Android) configuration file
A web server to store the Universal Link (iOS) configuration file
A backend server to exchange Tiktok's authorization code (after successful login) with Tiktok's access token

Development Status #
This project is still in development.
Demo #
Getting Started #

Create an app in Tiktok's Developers site.
Add Login Kit product and configure Login Kit for Android. Also configure Login Kit for iOS. If you have redirect uri error you can try to add trailing slash on your Login Kit's Redirect URI like this one: https://www.abc.com/login-callback/.
Configure App Link for Android (you can use Uni Links package ) and test the App Link is working.
Configure Universal Link for iOS (you can use Uni Links package ) and test the Universal Link is working.
Configure your Tiktok app's scopes. You can start with user.info.basic
Submit your app and make sure the status is Live in Production
Install this plugin package flutter pub add tiktok_api
Call the setup() method and pass your Tiktok's app client key: _tiktokSDKApi.setup('<API_KEY>')
Call the login() method and pass the scopes: _tiktokSDKApi.login(['user.info.basi'], 'https://www.abc.com/login-callback/', browserAuthEnabled)
Once the user authorized your Tiktok app, then Tiktok Login Kit will redirect back to your app using App Link (Android) or Universal Link (iOS). It is your job to handle the App Link or Universal Link redirection (step 3 above) and retrieve the authorization code. You have to exchange this authorization code with an access token. Once you get the access token you can use it to call all Tiktok's API. The exchange process must proceed in the backend. You can follow Tiktok's documentation to retrieve access token here.
You can see the example folder for the sample code on how to use this plugin library2023-12-01 18:10:46

Code of Conduct #
Please refer to our Code of Conduct document for guideline in the community.
Developer Guidelines #
Sequence Diagram #
There are two phases required. First, we have to do some setup to be able to communicate with the native side. Then we proceed with logging in to Tiktok and ask the user to authorize the scope of information that we requested. Once the user authorized then we have to exchange the authorization code with an access token. The access token will contains the impersonation credentials and the scopes. Once we got the access token we can use it to call all Tiktok APIs.
Setup Phase #
sequenceDiagram
Flutter App ->> Pigeon Host on Dart's side: setup()
Pigeon Host on Dart's side ->> Pigeon Host on iOS/Android side: setup()
Pigeon Host on iOS/Android side ->> Tiktok SDK: setup()

copied to clipboard
Getting Access Token #
sequenceDiagram
Flutter App ->> uni_link: setup App Link/Universal Link()
Flutter App ->> Pigeon Host on Dart's side: login()
Pigeon Host on Dart's side ->> Pigeon Host on iOS/Android side: login()
Pigeon Host on iOS/Android side ->> Tiktok SDK: login()
par Login Response and Web Browser running in parallel
Tiktok SDK -->> Pigeon Host on iOS/Android side: response{verifier, etc}
Pigeon Host on iOS/Android side -->> Pigeon Host on Dart's side: response{verifier, etc}
Pigeon Host on Dart's side -->> Flutter App: response{verifier, etc}
Flutter App ->> Flutter App: save response{verifier, etc} and wait for uni_link callback
and

par Web Browser Opening and the app put to background in parallel
Native OS ->> Flutter App: put on background
and

Tiktok SDK ->> Web Browser: open Tiktok's Login site
Web Browser ->> Web Browser: succesful login
Web Browser -->> Native OS: App Link or Universal Link callback {Authorization Code}
Native OS ->> Flutter App: put on foreground

Flutter App -->> Native OS: foreground success

Native OS -->> uni_link: App Link or Universal Link callback {Authorization Code}
uni_link -->> Flutter App: Retrieve Authorization Code from App Link/Universal Link
Flutter App ->> Backend Server: exchange token {verifier, Authorization Code}
Backend Server ->> Tiktok API: exchange token {verifier, Authorization Code}
Tiktok API -->> Backend Server: access token
Backend Server -->> Flutter App: access token
end



end


copied to clipboard
Development #
We are using Flutter pigeon package to provide us with the infrastructure to do birectional communication with the native sides.

We defined our pigeon.dart file. Containing the configuration for the code generator also the messaging data structure and the host interface.
We run dart run pigeon --input pigeon.dart and pigeon will generate all the communication infrastructure required also the implementation of the host interface.
We setup the native side host implementation
We instantiate the host interface implementation on our Dart's side and do remoting calls to the native side.