TikTok Login Kit for PHP

TikTok Login Kit implementation in PHP based on the official documentation.

This is an unofficial SDK for the official Login Kit APIs.

Features

The library has been updated to use the new TikTok v2 API version

Current features include:

• Log in with TikTok
• Retrieve Basic User Information
• Retrieve Advanced User Information
• Retrieve Videos
• Paginate Videos
• Refresh Expired Token

Installation

Install via Composer

composer require gimucco/tiktok-loginkit

Requirements

You need to have your app set up and approved in the TikTok Developer Portal.

If you're upgrading to the v2 TikTok API version, make sure you've added your Redirect URLs and selected the proper scopes.

Code Example for Logging in and retrieving basic info

// Initialize the class. 
// $client_id and $client_secret are provided by TikTok. 
// $redirect_uri must be approved in the TikTok developer portal.
$_TK = new TikTokLoginKit\Connector($client_id, $client_secret, $redirect_uri);
if (TikTokLoginKit\Connector::receivingResponse()) { 
	try {
		$token = $_TK->verifyCode($_GET[TikTokLoginKit\Connector::CODE_PARAM]);
		// Your logic to store the access token
		$user = $_TK->getUser();
		// Your logic to manage the User info
		$videos = $_TK->getUserVideoPages();
		// Your logic to manage the Video info
	} catch (Exception $e) {
		echo "Error: ".$e->getMessage();
		echo '<br /><a href="?">Retry</a>';
	}
} else {
	echo '<a href="'.$_TK->getRedirect().'">Log in with TikTok</a>';
}

Alternative Constructor

If you prefer to use a .ini file to pass the api credentials, you can use the TikTokLoginKit\Connector::fromIni method. The .ini file should have this simple structure

client_id = [your client id]
client_secret = [your client secret]
redirect_uri = [your redirect uri]

And you call the alternative constructor by passing the path to the .ini file

$_TK = TikTokLoginKit\Connector::fromIni(__DIR__.'/env.ini');

Examples

Refer to the examples folder for a quick examples of how to use the login, fetch and paginate videos