Post Script Configuratie

Deze pagina documenteert de configuratieparameters voor het post script dat gebruikt wordt bij het aanmaken van taken.

Overzicht

Het post script wordt gebruikt om automatisch inhoud (video's of afbeeldingen) te publiceren naar TikTok of Instagram. Het ondersteunt verschillende post methoden, materiaalbronnen en geluidsopties.

Verzoek Parameters

Bij het aanmaken van een taak kunt u de volgende top-level parameters specificeren:

Parameter	Type	Verplicht	Standaard	Beschrijving
serials	string[]	Voorwaardelijk	[]	Lijst van apparaat serienummers (Modus 1: apparaat-gebaseerd)
usernames	string[]	Voorwaardelijk	[]	Lijst van gebruikersnamen om taken voor te maken (Modus 2: gebruikersnaam-gebaseerd)
script_name	string	Ja	-	Script naam om uit te voeren (bijv. "post")
script_config	object	Ja	-	Script configuratieparameters (zie hieronder)
enable_multi_account	boolean	Nee	false	Multi-account modus inschakelen (taak aanmaken voor elk account op apparaat)
start_time	string	Nee	-	Optionele starttijd in formaat "HH:MM"
platform	string	Voorwaardelijk*	auto	Doelplatform: `tiktok`, `instagram`. Zie opmerking hieronder

Let op: serials of usernames moet worden opgegeven.

*Platform Parameter Gedrag:

TikMatrix & IgMatrix: De parameter platform wordt genegeerd indien opgegeven. Het platform wordt automatisch bepaald uit de app-naam (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: De parameter platform is verplicht en moet expliciet worden opgegeven als tiktok of instagram.

Script Configuratie (`script_config`)

Het script_config object bevat de parameters voor het post script. Hieronder staan de beschikbare parameters:

Gemeenschappelijke Parameters (TikTok & Instagram)

Parameter	Type	Verplicht	Standaard	Beschrijving
content_type	integer	Nee	0	Inhoudstype: `0` = Video, `1` = Afbeeldingen
image_count	integer	Nee	1	Aantal te selecteren afbeeldingen (wanneer content_type = 1)
captions	string	Nee	""	Bijschrifttekst voor de post. Ondersteunt spintax formaat: `{optie1\|optie2\|optie3}`
caption_format	string	Nee	"multiline"	Hoe multi-line bijschriften worden verwerkt: `multiline` (voegt echte nieuwe regels in) of `singleline` (vervangt `\n` door spaties)
ai_label	boolean	Nee	false	Of de AI-gegenereerde inhoudslabel aan het bericht moet worden toegevoegd
save_draft	boolean	Nee	false	Sla het bericht op als concept in plaats van direct te publiceren
post_way	string	Nee	"addButton"	Post methode: `share`, `addButton`, of `useSound`
material_source	string	Nee	"materialLibrary"	Materiaalbron: `materialLibrary` of `localFolder` (genegeerd als material_list is opgegeven)
material_path	string	Voorwaardelijk	""	Lokale map pad (verplicht wanneer material_source = "localFolder")
material_list	string[]	Nee	[]	Directe materiaalbestandpaden array. Wanneer opgegeven, omzeilt material_source en material_path logica. Ideaal voor API automatisering.
materials_tags	string	Nee	""	Komma-gescheiden materiaaltags voor filteren uit bibliotheek
upload_wait_time	integer	Nee	10	Seconden te wachten op voltooiing upload

upload_wait_time geldt zowel voor normaal posten als voor de modus save_draft. Zelfs wanneer je als concept opslaat, heeft TikTok/Instagram nog tijd nodig om de video-upload op de achtergrond af te ronden. | sound_wait_time | integer | Nee | 10 | Seconden te wachten op laden geluid | | add_sound | string/integer | Nee | "-1" | Geluidsoptie: -1 = standaard, 0 = uitschakelen, 1 = inschakelen, custom = gebruik aangepast geluid | | sound_name | string | Voorwaardelijk | "" | Geluidsnaam/URL (verplicht wanneer post_way = "useSound") | | custom_sound_keyword | string | Voorwaardelijk | "" | Zoekwoord om aangepast geluid te zoeken (verplicht wanneer add_sound = "custom") | | origin_sound_volume | integer | Nee | 100 | Origineel geluidsvolume (0-100) | | add_sound_volume | integer | Nee | 100 | Toegevoegd geluidsvolume (0-100) |

TikTok-specifieke Parameters

Parameter	Type	Verplicht	Standaard	Beschrijving
add_product_link	integer	Nee	0	Of een product-/winkelkoppeling moet worden toegevoegd: `0` = nee, `1` = ja

Instagram-specifieke Parameters

Parameter	Type	Verplicht	Standaard	Beschrijving
placement	string	Nee	"reel"	Post plaatsing: `reel` of `story`
enable_schedule_reels	boolean	Nee	false	Of de Reel voor een toekomstig tijdstip moet worden gepland
schedule_reels_time	string	Voorwaardelijk	""	Geplande publicatietijd in het formaat `YYYY-MM-DD HH:MM` (vereist wanneer enable_schedule_reels = true)
story_link	string	Nee	""	URL om als stickerlink toe te voegen aan een Story (alleen van toepassing wanneer placement = "story")

Voorbeelden

Basis Post Taak met Directe Materiaallijst

Dit is de aanbevolen aanpak voor API automatisering - geef materiaalpaden direct door zonder te vertrouwen op materiaalbibliotheek of mapscannen:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Check out my new video! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Post Taak met Materiaalbibliotheek (TikTok)

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": 0,
      "captions": "Check out my new video! #viral #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Post Taak op Gebruikersnaamlijst

Deze modus stelt u in staat om taken direct te maken voor specifieke accounts zonder hun apparaat serienummers te kennen:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@user1", "@user2", "@user3"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Check out my new video! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Post Taak met Lokale Map (Instagram)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Amazing content! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Post met Aangepast Geluid

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Dancing to this trending sound!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "trending dance 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Post met Specifieke Geluids URL

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "post_way": "useSound",
      "sound_name": "https://www.tiktok.com/music/original-sound-7123456789",
      "captions": "Using this awesome sound!",
      "material_source": "materialLibrary"
    }
  }'

Post Afbeeldingen (Carrousel)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "image_count": 5,
      "captions": "Check out these photos! #photocarousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Post met Expliciete Platformselectie

U kunt het doelplatform expliciet specificeren met de platform parameter. Dit is handig wanneer u de omgevingsstandaard wilt overschrijven:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "Plaatsen op Instagram! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Response

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

Zie Ook

Task Management API - Taken maken, weergeven en beheren

Overzicht​

Verzoek Parameters​

Script Configuratie (script_config)​

Gemeenschappelijke Parameters (TikTok & Instagram)​

TikTok-specifieke Parameters​

Instagram-specifieke Parameters​

Voorbeelden​

Basis Post Taak met Directe Materiaallijst​

Post Taak met Materiaalbibliotheek (TikTok)​

Post Taak op Gebruikersnaamlijst​

Post Taak met Lokale Map (Instagram)​

Post met Aangepast Geluid​

Post met Specifieke Geluids URL​

Post Afbeeldingen (Carrousel)​

Post met Expliciete Platformselectie​

Response​

Zie Ook​