본문으로 건너뛰기

本地 API 概览

TikMatrix 提供了一个本地的 RESTful API，允许你以编程方式管理任务。这对于将 TikMatrix 集成到你自己的自动化系统、构建自定义工作流程或创建批量操作非常有用。

要求​

许可证要求

本地 API 仅对 Pro、Team 和 Business 计划用户开放。 Starter 计划不提供 API 访问权限。

基础 URL​

API 在本机运行，地址为：

http://localhost:50809/api/v1/
노트

端口 50809 为默认端口。请在发起请求前确保 TikMatrix 已在运行。

响应格式​

所有 API 响应遵循以下格式：

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

响应码说明​

Code描述
0成功
40001参数错误 - 无效的请求参数
40002参数错误 - 缺少 script_name
40003参数错误 - 脚本暂不支持 API 调用
40301禁止 - API 访问需要 Pro+ 计划
40401未找到 - 资源不存在
50001服务器内部错误

快速开始​

1. 检查 API 访问权限​

首先，确认你的许可证是否支持 API：

curl http://localhost:50809/api/v1/license/check

示例响应：

{
  "code": 0,
  "message": "success",
  "data": {
    "plan_name": "Pro",
    "api_enabled": true,
    "device_limit": 20,
    "message": "API access enabled"
  }
}

2. 创建任务​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "captions": "看看我的新视频！#热门"
    },
    "enable_multi_account": false
  }'

3. 查询任务列表​

curl http://localhost:50809/api/v1/task?status=0&page=1&page_size=20

可用脚本​

当前支持

目前，本地 API 支持 post、follow、unfollow、account_warmup 和 comment 脚本。更多脚本将在未来版本中陆续添加。

script_name 参数可接受下列值：

스크립트 이름설명API 지원
post콘텐츠 게시✅ 지원됨
follow사용자 팔로우✅ 지원됨
unfollow사용자 언팔로우✅ 지원됨
account_warmup계정 워밍업✅ 지원됨
comment게시물에 댓글✅ 지원됨
login계정 로그인✅ 지원됨
profile프로필 업데이트✅ 지원됨
match_account기기의 계정 매칭✅ 지원됨
like좋아요✅ 지원됨
message다이렉트 메시지✅ 지원됨
super_marketing슈퍼 마케팅 캠페인🔜 출시 예정
scrape_user사용자 데이터 스크래핑🔜 출시 예정

任务状态​

状态码状态文本描述
0pending任务等待执行
1running任务正在执行
2completed任务执行成功
3failed任务执行失败

后续​