Hoppa till huvudinnehåll

Översikt över lokalt API

TikMatrix tillhandahåller ett lokalt RESTful API som gör det möjligt att hantera uppgifter programmatiskt. Detta är användbart för att integrera TikMatrix med dina egna automationssystem, bygga anpassade arbetsflöden eller skapa batch-operationer.

Krav​

Licenskrav

Det lokala API:et är endast tillgängligt för Pro, Team och Business-prenumeranter. Starter-planen har inte tillgång till API:et.

Bas-URL​

API:et körs på din lokala maskin på:

http://localhost:50809/api/v1/
anteckning

Porten 50809 är standardporten. Se till att TikMatrix körs innan du gör API-förfrågningar.

Svarsformat​

Alla API-svar följer detta format:

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

Svarskoder​

KodBeskrivning
0Framgång
40001Felaktig begäran - Ogiltiga parametrar
40002Felaktig begäran - Saknar script_name
40003Felaktig begäran - Script stöds inte eller ogiltigt uppgiftstillstånd
40004Felaktig begäran - Endast körbara uppgifter kan stoppas
40005Felaktig begäran - task_ids kan inte vara tom
40301Förbjuden - API-åtkomst kräver Pro+ plan
40401Hittades inte - Resurs hittades inte
50001Internt serverfel

Snabbstart​

1. Kontrollera API-åtkomst​

Först, verifiera att din licens stöder API-åtkomst:

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

Svar:

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

2. Skapa en uppgift​

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": "Check out my new video! #viral"
    },
    "enable_multi_account": false,
    "start_time": "14:30"
  }'

3. Lista uppgifter​

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

Tillgängliga scripts​

Parametern script_name accepterar följande värden:

Script-namnBeskrivningAPI-stöd
postPublicera innehåll✅ Stöds
followFölj användare✅ Stöds
unfollowSluta följa användare✅ Stöds
account_warmupVärm upp konton✅ Stöds
commentKommentera inlägg✅ Stöds
boost_commentGilla/svara på befintliga kommentarer✅ Stöds
loginLogga in på konto✅ Stöds
profileUppdatera profil✅ Stöds
match_accountMatcha konton på enhet✅ Stöds
likeGilla inlägg✅ Stöds
viewTitta på ett inlägg under en bestämd tid✅ Stöds
favoriteSpara ett inlägg i Favoriter✅ Stöds
repostReosta TikTok-videor✅ Stöds
messageSkicka direktmeddelanden✅ Stöds
follow_suggestedFölj föreslagna konton✅ Stöds
super_marketingSuper marknadsföringskampanj✅ Stöds †
scrape_userSkrapa användardata🔜 Kommer snart
† Super marketing använder dedikerade slutpunkter

Super marketing-kampanjen skapas inte via POST /api/v1/task. Den körs på en återanvändbar måldatamängd med egna slutpunkter — se Konfiguration av Super Marketing Script.

Uppgiftsstatus​

StatuskodStatustextBeskrivning
0pendingUppgiften väntar på att utföras
1runningUppgiften körs för närvarande
2completedUppgiften slutfördes framgångsrikt
3failedUppgiften misslyckades

Nästa steg​