swuppio/tiktok-wrapper

抖音 PHP 封装器

1.0.0 2024-02-23 15:17 UTC

This package is auto-updated.

Last update: 2024-09-25 19:56:20 UTC


README

该项目是一个封装器,旨在简化与抖音API的交互,重点关注认证和显示API部分。这些组件是我个人项目需求的主要关注点。然而,这个封装器在设计时就考虑了扩展性。

如果需要超出当前实现的功能,我愿意扩展这个封装器的功能。如果您需要更多功能,请随时打开一个问题,详细说明您的需求。这将有助于增强封装器,以满足抖音API功能中更广泛的需求。

入门指南

先决条件

要使用这个封装器,您需要在机器上安装PHP 8.1或更高版本

安装

安装通过Composer完成。要在项目中安装组件,请在项目目录中运行以下命令

composer require swuppio/tiktok-wrapper

示例

在这些示例中,您将看到如何使用抖音封装器执行常见任务,例如获取用户的用户名和刷新过期的认证令牌。

获取用户用户名

$wrp = new TikTokWrapper();

$authDto = $wrp
    ->getAuthApi('CLIENT_KEY', 'CLIENT_SECRET')
    ->fetchAccessToken('CODE', 'http://site.com/redirect_uri');

$displayApi = $wrp->getDisplayApi($authDto->accessToken);

$userInfoDto = $displayApi
    ->getUserInfo()
    ->setFields(
        UserInfoContract::Username->value,
        // ...
    )
    ->get();

echo $userInfoDto->username;

刷新过期的认证令牌

$wrp = new TikTokWrapper();

$authDto = $wrp
    ->getAuthApi('CLIENT_KEY', 'CLIENT_SECRET')
    ->refreshAccessToken('REFRESH_TOKEN');

echo $authDto->accessToken;

通过ID请求视频信息

# code...

$displayApi = $wrp->getDisplayApi('ACCESS_TOKEN');

$queryVideosArr = $displayApi
    ->getQueryVideos()
    ->setFields(
        VideoContract::EmbedHtml->value,
        // ...
    )
    ->setVideoIds([
        '7251141220062350593',
        // ...
    ])
    ->get();

foreach ($queryVideosArr->videos as $video) {
    echo $video->embedHtml;
}

有关抖音封装器所有功能及其更多示例的更详细信息,请参阅完整文档

许可

该项目受MIT许可协议的许可 - 有关详细信息,请参阅LICENSE.md文件。