Favorite-script Configuratie

Deze pagina documenteert de configuratieparameters voor het favorite-script.

Overzicht

Het favorite-script voegt een bericht toe aan Favorieten (op TikTok) / Opgeslagen (op Instagram). Met meerdere doel-URLs via de API, wordt één taak per doel-URL aangemaakt. Stuur uitvoeringstijd met de start_time parameter.

Al opgeslagen berichten worden overgeslagen

Het script detecteert berichten die al zijn opgeslagen en slaat ze over, zodat het opnieuw uitvoeren van een taak een bericht niet terugzet.

Scriptconfiguratie (script_config)

Configuratieparameters voor het favorite-script:

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
target_post_urls	string[]	Ja*	[]	Array van doel-URLs om op te slaan (één taak per URL)
target_post_url	string	Ja*	""	Enkelvoudige doel-URL of meerdere URLs gescheiden door regeleinden/komma's

notitie

Ofwel target_post_urls-array of target_post_url-string moet worden opgegeven. Als beide, heeft target_post_urls prioriteit.

Taak aanmaken

Met meerdere doel-URLs maakt de API één taak per doel-URL aan. Bijvoorbeeld: 3 URLs + 2 apparaten = 6 taken. Gebruik start_time om te bepalen wanneer taken starten.

Voorbeelden

Één bericht opslaan

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    }
  }'

Meerdere berichten opslaan

Met meerdere berichten wordt één taak per bericht aangemaakt:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_urls": [
        "https://www.tiktok.com/@user1/video/111",
        "https://www.tiktok.com/@user2/video/222",
        "https://www.tiktok.com/@user3/video/333"
      ]
    }
  }'

Dit maakt 3 afzonderlijke taken die direct worden uitgevoerd.

Opslaan plannen met begintijd

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@username/video/1234567890"
    },
    "start_time": "14:30"
  }'

Opslaan via gebruikersnaamlijst

Maak favorite-taken voor specifieke accounts:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@target/video/123"
    }
  }'

Instagram voorbeeld

Threads

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

threads.net links werkenzichtbaar ook. Een /share/ link niet: de code ervan is een ander ID dan wat een post-pagina gebruikt, dus het wordt geweigerd in plaats van omgezet in een URL die nergens heen wijst. Op Instagram slaat het favorite-script het bericht op (bladwijzer):

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "favorite",
    "script_config": {
      "target_post_url": "https://www.instagram.com/p/ABC123/"
    }
  }'

Reactie

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [601, 602, 603],
    "created_count": 3
  }
}

URL-formaten

TikTok

https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/

Instagram

Threads

https://www.threads.com/@username/post/ABCDEFGHIJK
https://www.threads.com/t/ABCDEFGHIJK

threads.net links werkenzichtbaar ook. Een /share/ link niet: de code ervan is een ander ID dan wat een post-pagina gebruikt, dus het wordt geweigerd in plaats van omgezet in een URL die nergens heen wijst.

https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/

Aanbevolen Procedures

1. Plan taken: Gebruik de start_time parameter om acties over de tijd te spreiden.

2. Multi-account: Schakel enable_multi_account in om berichten op te slaan met meerdere accounts op hetzelfde apparaat.

Foutcodes

Code	Beschrijving
40001	Doel-URL ontbreekt
40003	Script niet ondersteund via API
40301	Pro+-abonnement vereist

Zie Ook

• Like-script Configuratie - Like posts
• View-script Configuratie - Berichten bekijken voor een duur
• Taakbeheer API - Taken aanmaken, beheren en opvragen
• Local API Overzicht - API-overzicht en snelstart