$(customapi)

Überblick

Mit $(customapi ...) kann dein Bot Informationen von anderen Webseiten abrufen und im Chat anzeigen. Das ist nützlich, wenn du z.B. Witze, Statistiken oder andere Daten von externen Diensten in deinen Chat holen möchtest.

$(urlfetch ...) ist ein anderer Name für das gleiche Feature - beides funktioniert identisch.

Syntax

Es gibt zwei Varianten:

1. Die komplette Antwort anzeigen:

$(customapi URL)

Wenn du einfach alles anzeigen möchtest, was die Webseite zurückgibt.

2. Nur einen bestimmten Teil anzeigen:

$(customapi URL | json.pfad)

Manchmal gibt eine Webseite viele verschiedene Informationen zurück, aber du brauchst nur einen kleinen Teil davon. Dann kannst du den gewünschten Teil mit einem sogenannten "JSON-Pfad" auswählen.

Beispiele

$(customapi https://api.example.com/joke)

$(customapi https://official-joke-api.appspot.com/random_joke | setup)

$(urlfetch https://api.example.com/stats?channel=$(channel) | data.viewerCount)

Wo kann ich das verwenden?

Du kannst $(customapi ...) an folgenden Stellen einsetzen:

• Bot → Befehle - In deinen Chat-Befehlen
• Bot → Timer - In automatischen Timer-Nachrichten
• Bot → Chat Alerts - In Alert-Nachrichten
• Chat Automation → Raid Shoutout - Bei Raid-Ankündigungen
• Stream Tools → Clip Command - Wenn du eine eigene Antwortvorlage nutzt

Hinweise

• Es funktionieren nur normale Webseiten-Links (URLs, die mit http:// oder https:// beginnen).
• Die Antwort wird auf maximal 450 Zeichen gekürzt und in einer Zeile angezeigt.
• Aus Sicherheitsgründen sind private Adressen und localhost gesperrt.
• Der JSON-Pfad (der Teil nach dem |) funktioniert nur, wenn die Webseite ihre Daten im JSON-Format zurückgibt. Wenn du dir nicht sicher bist, probiere es einfach erst ohne den JSON-Pfad aus!