Schnellstart

Diese Anleitung zeigt das Minimum für einen Scrumball-API-Aufruf: die Basis-URL, eine Statusprüfung ohne Authentifizierung und eine erste authentifizierte Anfrage. Jedes Codebeispiel lässt sich unverändert ins Terminal einfügen.

Nutzen Sie für den Produktivbetrieb direkt die OpenAPI-Basis-URL. Anfragen aus `/docs` dienen nur dem Debugging und laufen über das Scrumball-Backend, damit der Schlüssel nicht im Browser landet.

Base URL

text
https://openapi.scdata.cc
1. Bei Scrumball anmelden und das Dashboard öffnen
2. Prüfen, ob das Konto ein Test- oder aktives Abo-Kontingent hat
3. Im Dashboard unter „API Keys“ einen Schlüssel erstellen
4. Anfragen vom eigenen Server mit der echten Basis-URL senden

Statusprüfung

bash
curl -X GET "https://openapi.scdata.cc/api/ping"

Erster authentifizierter Aufruf

bash
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/info?unique_id=nike" \
-H "Authorization: YOUR_API_KEY"

Verhalten von „Ausprobieren“

Anfragen aus `/docs` laufen zuerst über das Scrumball-Backend und werden dann an den vorgelagerten OpenAPI-Dienst weitergeleitet. Rufen Sie im Produktivbetrieb die Basis-URL direkt auf, statt sich auf diesen Proxy zu verlassen.