Ga naar hoofdinhoud

Local API Overzicht

Scriptupdate\nThreads in Pro ondersteunt message, follow_back, scrape_users en repost; content_type = 2 bij post betekent een tekstbericht. Het zelfstandige message-script is niet beschikbaar voor TikTok/Instagram; gebruik Super Marketing.\n:::

TikMatrix biedt een lokale RESTful API waarmee u taken programmatisch kunt beheren. Dit is handig voor het integreren van TikMatrix met uw eigen automatiseringssystemen, het bouwen van aangepaste workflows of het maken van batchbewerkingen.

Vereisten​

Licentie Vereiste

De Local API is alleen beschikbaar voor Pro, Team en Business plan abonnees. Het Starter plan heeft geen toegang tot de API.

Basis URL​

De API draait op uw lokale machine op:

http://localhost:50809/api/v1/
notitie

De poort 50809 is de standaard poort. Zorg ervoor dat TikMatrix draait voordat u API verzoeken doet.

Response Formaat​

Alle API responses volgen dit formaat:

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

Response Codes​

CodeBeschrijving
0Succes
40001Ongeldig verzoek - Ongeldige parameters, waaronder een script_config die de validatie niet doorstaat
40002Bad Request - Ontbrekende script_name
40003Ongeldig verzoek - Script niet ondersteund op deze build of dit platform, zonder implementatie, of ongeldige taakstatus
40004Bad Request - Alleen lopende taken kunnen worden gestopt
40005Bad Request - task_ids kan niet leeg zijn
40301Forbidden - API toegang vereist Pro+ plan
40401Not Found - Resource niet gevonden
50001Internal Server Error

Snelstart​

1. Controleer API Toegang​

Controleer eerst of uw licentie API toegang ondersteunt:

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

Response:

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

2. De scripts en hun parameters opvragen​

GET /api/v1/schema beschrijft elk script dat deze build kan uitvoeren en precies welke script_config-velden het aanneemt: namen, typen, standaardwaarden, toegestane waarden en welke verplicht zijn. Het wordt gegenereerd uit dezelfde catalogus waartegen de server valideert, dus het kan niet afwijken van wat het aanmaken van taken accepteert.

curl http://localhost:50809/api/v1/schema

Twee optionele queryparameters:

ParameterEffect
platformBeperkt de lijst tot tiktok, instagram of threads. Een platform dat deze build niet meelevert wordt afgewezen met 40001. Standaard alles wat de build meelevert.
include_unavailableOp true worden ook scriptnamen getoond die de API accepteert maar die geen werkende implementatie hebben. Elk draagt een unavailable_reason.

Antwoord (ingekort):

{
  "code": 0,
  "message": "success",
  "data": {
    "build": { "platforms": ["tiktok"] },
    "scripts": [
      {
        "name": "follow",
        "internal_name": "follow",
        "summary": "Follow the given users. One task per target.",
        "platforms": ["tiktok", "instagram", "threads"],
        "available": true,
        "fan_out": { "kind": "per_item", "key": "target_users", "alt_key": "target_user" },
        "any_of": [["target_users", "target_user"]],
        "fields": [
          {
            "key": "access_method",
            "type": "string",
            "required": false,
            "default": "direct",
            "choices": ["direct", "search"],
            "description": "How to reach the profile: direct (via URL) or search."
          }
        ]
      }
    ]
  }
}

fan_out zegt hoeveel taken een verzoek oplevert: per_device maakt één taak per apparaat (of per account in multi-accountmodus), per_item maakt er één per item van het genoemde veld, per apparaat.

3. Maak een Taak​

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"
  }'

4. Lijst Taken​

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

Beschikbare Scripts​

De script_name parameter accepteert de volgende waarden:

Script NaamBeschrijvingAPI Ondersteuning
postVideo's, afbeeldingen of alleen-tekst-berichten van Threads publiceren✅ Ondersteund
followGebruikers volgen✅ Ondersteund
unfollowGebruikers ontvolgen✅ Ondersteund
account_warmupAccounts opwarmen✅ Ondersteund
commentEen nieuwe opmerking plaatsen op berichten✅ Ondersteund
boost_commentBestaande opmerkingen liken / erop reageren✅ Ondersteund
loginInloggen op account✅ Ondersteund
profileProfiel bijwerken✅ Ondersteund
match_accountAccounts op apparaat koppelen✅ Ondersteund
likeBerichten liken✅ Ondersteund
viewEen bericht gedurende een bepaalde duur bekijken✅ Ondersteund
favoriteEen bericht opslaan in Favorieten✅ Ondersteund
repostTikTok-video's of Threads-berichten herplaatsen✅ Ondersteund — TikTok en Threads
messageDirecte berichten versturen✅ Ondersteund — alleen Threads
follow_backAccounts volgen uit de volgerslijst✅ Ondersteund — TikTok, Instagram en Threads
follow_suggestedVoorgestelde accounts volgen✅ Ondersteund — alleen TikTok
custom_scriptEen zelf geregistreerd programma uitvoeren✅ Ondersteund ‡
super_marketingSuper marketingcampagne✅ Ondersteund †
scrape_usersGebruikersnamen van volgers, gevolgde accounts of zoekresultaten exporteren✅ Ondersteund — TikTok, Instagram en Threads
auto_replyDirecte berichten en opmerkingen beantwoorden❌ Niet via API §
† Super marketing gebruikt eigen eindpunten

De super marketingcampagne wordt niet aangemaakt via POST /api/v1/task. Ze werkt met een herbruikbare doeldataset en heeft eigen eindpunten — zie Super Marketing Script Configuratie.

Directe berichten alleen op Threads

De losstaande message-taak doorloopt de flow Profiel → Bericht in Threads. Voor TikTok en Instagram gebruik je in plaats daarvan super_marketing met een doeldataset.

Platformspecifieke scripts

repost is geïmplementeerd voor TikTok en Threads; follow_suggested blijft alleen voor TikTok. follow_back en scrape_users gebruiken de volger- en zoekinterface van elk platform op een echt toestel en zijn beschikbaar op TikTok, Instagram en Threads.

‡ Aangepaste scripts moeten eerst worden geregistreerd

custom_script voert een programma uit dat je hebt geregistreerd onder Apparaten → Aangepaste scripts. Geef het id ervan door in script_config.custom_script_id — zie Aangepaste scripts.

§ Automatisch antwoorden draait vanaf een eigen pagina

auto_reply beantwoordt directe berichten en opmerkingen op TikTok, Instagram en Threads, met het Pro-abonnement of hoger. De rondes worden ingepland op de pagina Automatisch antwoorden in de app, waar de antwoordregels, werktijden en de pauzeknop staan. Daarom kan het niet worden aangemaakt via POST /api/v1/task.

script_config-validatie​

Bij het aanmaken van een taak wordt script_config eerst tegen bovenstaand schema gevalideerd, zodat een verkeerde parameter terugkomt als een 400 die het veld noemt, in plaats van als een taak die later op de telefoon mislukt. Drie dingen worden afgewezen:

  • een verplicht veld dat ontbreekt of leeg is,
  • een of-of-groep waarvan geen enkel lid is ingevuld (follow heeft bijvoorbeeld target_users of target_user nodig),
  • een waarde buiten de gedocumenteerde choices van een veld.

Sleutels die het schema niet kent worden genegeerd, niet afgewezen — de desktop-app stuurt eigen sleutels door hetzelfde object, en onbekende sleutels weigeren zou bestaande integraties breken. Ze worden serverzijdig gelogd zodat je een typefout in het app-log kunt vinden.

Getallen mogen als tekst worden verstuurd ("20" net zo goed als 20), passend bij wat de scripts al accepteren.

Taak Status​

Status CodeStatus TekstBeschrijving
0pendingTaak wacht om uitgevoerd te worden
1runningTaak wordt momenteel uitgevoerd
2completedTaak succesvol voltooid
3failedTaak mislukt

Volgende Stappen​