TikTok Open API 视频列表接口的 fields 参数正确调用方式-php教程-PHP中文网

TikTok Open API 视频列表接口的 fields 参数正确调用方式

TikTok Video List 接口不支持通过 GET 请求传递 fields 参数，必须改用 POST 方法并以 JSON Body 形式提交参数（含 fields 数组），否则将返回 404 错误。

tiktok video list 接口不支持通过 get 请求传递 `fields` 参数，必须改用 post 方法并以 json body 形式提交参数（含 `fields` 数组），否则将返回 404 错误。

TikTok Open API 的 /video/list 端点对请求方式有严格要求：fields 参数仅在 POST 请求中有效，且必须作为 JSON 格式的请求体（Request Body）传递，而非 URL 查询参数。若沿用 GET 方式（如拼接 &fields=like_count），API 将无法识别该字段，直接返回 HTTP 404 —— 这并非路径错误，而是 TikTok 服务端主动拒绝了不合规的请求格式。

✅ 正确做法如下：

使用 POST 方法，请求 URL 保持简洁：https://open-api.tiktok.com/video/list/（结尾不带查询参数）；
构造 JSON 请求体，fields 必须是字符串数组（如 ["like_count", "share_count", "embed_html"]），不可为单个字符串或逗号分隔字符串；
设置必要 Header：Content-Type: application/json（强烈建议显式声明，避免部分环境解析失败）；
确保其他必填字段完整：access_token、open_id、cursor、max_count 均需包含在 JSON Body 中。

以下是可直接运行的 PHP 示例（含错误处理与推荐 Header）：

Larry — Autonomous TikTok Slideshow Agent

自动生成并安排6页TikTok幻灯片，搭配热门开头和图片，关联你的联盟文章，使用NVIDIA FLUX和Postiz。

下载

<?php $tik_token = $tik_tok_access;
$tik_open_tk = $tik_open;

$url = 'https://open-api.tiktok.com/video/list/';
$data = json_encode([
    'access_token' => $tik_token,
    'open_id'      => $tik_open_tk,
    'cursor'       => 0,
    'max_count'    => 1,
    'fields'       => ['like_count', 'share_count', 'comment_count', 'embed_link']
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'User-Agent: TikTok-API-Client/1.0'
]);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($http_code === 200) {
    $result = json_decode($response, true);
    print_r($result);
} else {
    echo "HTTP Error: {$http_code}\n";
    echo "Response: {$response}\n";
}

⚠️ 注意事项：

fields 支持的字段请严格参考官方文档的最新列表（如 embed_html、share_count、like_count 等），非法字段会导致整个请求失败；
cursor 和 max_count 为必需整数，不可省略或传字符串；
不要对 JSON 数据手动拼接或使用 file_get_contents() 发送 POST —— 它默认为 GET，无法携带 body；
生产环境务必添加异常捕获、token 有效期校验及重试机制。

总结：TikTok 的 /video/list 是典型的「POST-only with JSON body」设计。理解并遵守其接口契约（而非套用通用 REST 习惯），是避免 404 的关键。