您需要以编程方式获取TikTok用户详细信息,以支持用户管理流程——在入职期间验证帐户、丰富个人资料或将存储的记录与实时数据进行对账。在本指南结束时,您将能够调用真实的“获取用户信息”端点,处理其响应,并将其接入生产工作流,提供可直接粘贴到您代码库中的curl和Python示例。
此API的功能及其对用户管理的帮助
Zyla API Hub上的TikTok数据API公开了两个只读端点,您可以使用单个API密钥进行调用:
- 获取用户信息:通过
user_id返回有关TikTok用户的信息。这是用户验证和同步任务的核心构建块。 - 获取视频信息:通过
url返回视频级元数据。当您的用户管理流程需要将用户与其共享内容关联或验证提交的视频URL是否有效并属于预期帐户时,这非常有用。
典型的用户管理用例包括:
- 验证在注册期间提供的TikTok
user_id或将现有个人资料链接到客户帐户。 - 使用您可以在下游系统中可靠地使用的规范ID丰富您的用户表。
- 审核用户提供的视频URL,并在授予访问受限功能之前将其与其帐户相关联。
您可以使用单个市场帐户和API密钥访问这两个端点,采用基于订阅的计费和配额。这里的第一个API提供7天的试用(或50个请求)。没有免费计划;请查看API页面以获取当前访问选项和定价。
在Zyla API Hub上开始
打开Zyla API Hub上的TikTok数据API列表,点击订阅或在可用时开始免费试用,并复制您的API密钥。所有请求都包括一个用于身份验证的单一头部:
- 头部:
Authorization: Bearer YOUR_API_KEY
在这里开始您的试用:在TikTok数据API上开始7天试用。您将在几分钟内调用生产级端点。
端点参考
获取用户信息
当您拥有TikTok user_id并需要获取该用户的信息时,请使用此端点。这是用户验证和同步的核心。
- 方法:GET
- URL:https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info
- 所需参数:
user_id(字符串):TikTok用户ID。示例:107955
官方curl示例:
curl -s -X GET "https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info?user_id=107955" \
-H "Authorization: Bearer YOUR_API_KEY"
官方示例响应:
{
"code": -1,
"msg": "用户信息获取失败!请检查unique_id或user_id。",
"processed_time": 0.1441
}
您实际使用的字段说明:
code:整数结果指示符。此处的负值表示请求未返回所提供标识符的用户数据。msg:用于帮助错误处理的诊断消息(例如,无效或不存在的ID)。processed_time:处理时间(秒,浮动)。对于可观察性和预算重试非常有用。
生产提示:将msg与您的验证尝试一起存储,以便您的支持团队在审核用户入职问题时能够区分格式错误的ID和未找到的情况。
获取视频信息
当您需要验证或丰富包含TikTok视频URL的用户提交时,请使用此端点。当用户链接内容以证明所有权或资格时,这很常见。
- 方法:GET
- URL:https://zylalabs.com/api/2516/tiktok-data-api/2504/get-video-info
- 所需参数:
url(字符串):特定格式的TikTok视频URL。
注意:视频URL必须采用以下格式https://www.tiktok.com/@khaby.lame/video/7411964588809342241。官方curl示例:
使用返回的字段确认视频存在,并提取帮助您将内容与系统中的用户个人资料相关联的标识符。如果您在此URL旁边收集了用户的TikTok用户名,您可以在允许诸如加入创作者计划或解锁高级功能等操作之前交叉检查两者。
Python中的工作示例
下面的代码片段使用文档参数和身份验证方案调用获取用户信息,然后根据code的值决定是否将TikTok帐户附加到您的内部用户记录或标记以供审核。
import requests
API_KEY = "YOUR_API_KEY"
USER_ID = "107955" # 提供您在用户流程中收集的user_id
url = "https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info"
params = {"user_id": USER_ID}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
# 用户管理流程的最小分支逻辑
if isinstance(data, dict) and data.get("code") == 0:
# 示例:在您的用户表中持久化验证的TikTok链接
# save_user_tiktok_link(internal_user_id, USER_ID, data)
print("用户信息已检索并存储。")
else:
# 记录诊断并提醒您的支持或风险系统
print(f"用户验证失败,用户ID为 {USER_ID}。")
print(f"code={data.get('code')} msg={data.get('msg')} processed_time={data.get('processed_time')}")
注意:
- 超时:根据您的环境设置一个合适的超时;上面的20秒是一个示例。
- 重试:仅在网络级超时或5xx错误时重试幂等的GET请求,而不是在JSON中的应用级错误代码上。
- 可观察性:将
processed_time与您的日志上下文一起存储,以跟踪随时间变化的延迟。
围绕这些端点设计用户管理流程
以下是您可以直接在服务层和队列中适应的最小但有效的模式。
- 使用TikTok ID注册:
- 在您的表单中收集
user_id并将其存储在待处理状态。 - 立即调用获取用户信息;如果
code指示成功,则将链接标记为已验证并继续您的流程。 - 如果响应指示失败,则根据
msg向用户返回精确的内联错误,并在必要时排队支持审核。
- 在您的表单中收集
- 将TikTok视频链接到用户个人资料:
- 从用户处收集以文档格式提供的视频
url。 - 调用获取视频信息并确认视频是否解析。如果您还拥有用户的TikTok
user_id,请从视频元数据中关联标识符以获得额外的保证,然后再持久化。
- 从用户处收集以文档格式提供的视频
- 定期重新同步:
- 安排一个作业以重新验证存储的
user_id值,使用获取用户信息对样本或完整帐户集进行验证,具体取决于您的配额。 - 记录更改并在先前有效的链接开始失败时提醒产品运营。
- 安排一个作业以重新验证存储的
节省时间的操作提示
- 身份验证:始终发送
Authorization: Bearer YOUR_API_KEY。请勿添加额外的头部或尝试在查询中输入密钥,除非明确记录(此API不适用)。 - 请求形状:两个端点均为GET,仅带查询参数;没有请求体。
- 处理时间:
processed_time浮动值以秒为单位;对于性能仪表板和服务级目标(SLO)非常有用。 - 缓存:如果您缓存用户查找,请尊重用户面向身份可能会更改的事实。对于关键验证流程,使用短TTL,对于非关键丰富流程使用更长的TTL。
- 错误处理:根据JSON
code进行分支,并检查msg以获取面向用户的指导或内部日志记录;将网络错误和JSON级错误区分对待。 - 配额规划:市场使用订阅+配额(而不是按调用计费)。这里的第一个API支持7天的试用或50个请求,以帮助您集成。请在您的Zyla仪表板中监控使用情况,并相应地调整批处理作业的大小。
快速参考:确切的参数和URL
- 获取用户信息
- GET https://zylalabs.com/api/2516/tiktok-data-api/2503/get-user-info
- 参数:
user_id(字符串,必需)
- 获取视频信息
- GET https://zylalabs.com/api/2516/tiktok-data-api/2504/get-video-info
- 参数:
url(字符串,必需),格式如https://www.tiktok.com/@khaby.lame/video/7411964588809342241
用例映射到端点
- 帐户链接:使用获取用户信息确认TikTok帐户存在,然后再将其保存到用户个人资料中。
- 创作者功能的资格检查:使用获取视频信息验证提交的视频URL,然后仅在查找成功时继续。
- 支持工具:在您的管理界面中添加“重新验证TikTok”按钮,调用获取用户信息并将
msg呈现给您的团队。
通过MCP从AI代理调用此API
您还可以通过与MCP兼容的开发工具和代理(例如Claude Code、Cursor、Windsurf)使用Zyla MCP网关调用这些HTTP端点。将您的客户端指向MCP端点并传递您的API密钥:
- MCP URL:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
从您的代理发出与上面显示的相同的HTTPS GET请求(包括Authorization头)。这使您可以在代码审查或基于运行手册的操作期间脚本化一键验证,而无需将秘密硬编码到本地脚本中。有关更多信息,请参阅文档:MCP。
故障排除
- 在获取用户信息时获取
code: -1:确认提供的user_id是正确的。以友好的方式向用户显示msg(例如,“请仔细检查您的TikTok用户ID”)。 - 视频URL不匹配:确保URL遵循文档格式,包括路径结构。如果您捕获语言查询参数(例如,
?lang=en),请保持它们按示例curl进行URL编码。 - HTTP 401:验证您的Authorization头使用Bearer方案,并且密钥未过期或未被轮换。
- 可观察性:记录每个请求的
processed_time以识别间歇性的慢响应并微调重试。
常见问题
TikTok数据API期望什么身份验证头?
在每个请求中发送Authorization: Bearer YOUR_API_KEY。
我可以向这些端点发送POST主体吗?
不可以。这两个文档端点都是GET,仅通过查询字符串接受参数。
processed_time代表什么?
这是您请求的服务器端处理时间(以秒为单位)。用于性能监控和警报。
是否有免费计划?
没有。市场使用订阅+配额,而不是按调用计费。这里的第一个API提供7天的试用或50个请求,以便您在承诺之前进行集成。有关当前访问选项和定价,请查看API页面。
视频URL格式有多严格?
您必须提供以端点描述中显示的格式提供的URL(例如,https://www.tiktok.com/@khaby.lame/video/7411964588809342241)。如果存在,请保持查询参数按URL编码。
发布您的集成
您现在拥有确切的URL、参数和工作示例,以验证TikTok用户并在您的用户管理流程中验证他们提交的内容。创建您的帐户,获取API密钥,并在此处开始您的7天试用:在TikTok数据API上开始7天试用。一个帐户覆盖Zyla API Hub上数千个生产就绪的API,使用单个密钥和订阅模型。