Zum Hauptinhalt springen

Favorite-Skript-Konfiguration

Diese Seite beschreibt die Konfigurationsparameter für das favorite-Skript bei der Aufgabenerstellung.

Übersicht​

Das favorite-Skript fügt einen Beitrag zu Favoriten (auf TikTok) bzw. Gespeichert (auf Instagram) hinzu. Wenn Sie über die API mehrere Ziel-Beitrags-URLs angeben, wird für jede URL eine Aufgabe erstellt. Sie können den Ausführungszeitpunkt jeder Aufgabe mit dem start_time-Parameter steuern.

Bereits als Favorit gespeicherte Beiträge werden übersprungen

Das Skript erkennt Beiträge, die bereits als Favorit / gespeichert markiert sind, und überspringt sie. Ein erneutes Ausführen einer Aufgabe macht den Vorgang also nicht rückgängig.

Skript-Konfiguration (script_config)​

Das script_config-Objekt enthält die Konfigurationsparameter für das Favorite-Skript. Nachfolgend sind die verfügbaren Parameter aufgeführt:

Parameter​

ParameterTypErforderlichStandardBeschreibung
target_post_urlsstring[]Yes*[]Array von Ziel-Beitrags-URLs zum Favorisieren (eine Aufgabe pro URL)
target_post_urlstringYes*""Einzelne Ziel-Beitrags-URL oder mehrere URLs, getrennt durch Zeilenumbrüche/Kommas
hinweis

Es muss entweder das target_post_urls-Array oder die target_post_url-Zeichenkette angegeben werden. Wenn beide angegeben sind, hat target_post_urls Vorrang.

Aufgabenerstellung

Bei mehreren Ziel-Beitrags-URLs erstellt die API eine Aufgabe pro URL. Beispiel: Bei 3 Beitrags-URLs und 2 Geräten werden 6 Aufgaben erstellt. Verwenden Sie den start_time-Parameter, um die Startzeit der Aufgaben zu steuern.

Beispiele​

Einen Beitrag als Favorit speichern​

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

Mehrere Beiträge als Favorit speichern​

Beim Speichern mehrerer Beiträge wird für jeden Beitrag eine Aufgabe erstellt:

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

Dadurch werden 3 separate Aufgaben erstellt, die sofort ausgeführt werden.

Favoriten mit Startzeit planen​

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

Beiträge per Benutzernamen-Liste als Favorit speichern​

Favorite-Aufgaben direkt für bestimmte Konten erstellen:

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-Beispiel (Beitrag speichern)​

Auf Instagram speichert das favorite-Skript den Beitrag (Lesezeichen):

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

Antwort​

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

Beitrags-URL-Formate​

TikTok​

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

Instagram​

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

Best Practices​

  1. Aufgaben planen: Verwenden Sie den start_time-Parameter, um Aktionen über die Zeit zu verteilen und Rate-Limiting zu reduzieren.

  2. Multi-Account-Modus nutzen: Aktivieren Sie enable_multi_account, um Beiträge mit mehreren Konten auf demselben Gerät zu favorisieren.

Fehlercodes​

CodeDescription
40001Fehlende Ziel-Beitrags-URL
40003Skript wird über API nicht unterstützt
40301API-Zugang erfordert Pro+-Plan

Siehe auch​