Developer

Auf API & SDKs aufbauen

7:50 Rundgang

Die Erzählstimme im Video ist auf Englisch.

Die Toktik Developer API ist eine abgerechnete REST-API, dazu offizielle SDKs — @toktikhq/sdk-js für JavaScript/TypeScript und toktik für Python. Beginne mit Quickstart, Auth und Credits und kopiere dann fertige Beispiele für cURL, JavaScript und Python.

Das lernst du

Einen Key erzeugen und den ersten authentifizierten Request senden
Scopes, Rate Limits und das Credit-Modell verstehen
Die SDKs für JavaScript und Python nutzen
Die Docs lesen: Quickstart, Endpoints und Scopes

So funktioniert es

Einen Key in Settings erstellen
Öffne in der App Settings, dann Developer keys, und erstelle einen Key nur mit den Scopes, die du brauchst, etwa rank:read für Rankings. Das Secret beginnt mit ttk_live_ und wird einmal angezeigt, speichere es also in einer Umgebungsvariable. Keys erreichen nur Daten-Routen, und das Erstellen von Keys bleibt eine Aktion im angemeldeten Zustand.
Den ersten Request senden
Sende den Key als Authorization: Bearer mit deinem ttk_live_-Secret. Der Quickstart in den Docs ruft das offizielle Ranking unter api.toktikhq.com/v1/rankings/official mit board=hourly und region=VN ab. Ein 403 bedeutet, dass dem Key der Scope für diese Route fehlt.
Mit Limits und Credits arbeiten
Jeder Key hat je nach Tarif ein Request-Limit pro Sekunde, von 1 bei Free bis 150 bei Agency. Über dem Limit erhältst du 429, warte also auf Retry-After und wiederhole. Sind die Credits aufgebraucht, kommt 402, was ein Wiederholen nicht behebt, und GET /v1/usage zeigt deinen Verbrauch.
Ein offizielles SDK hinzufügen
Installiere npm i @toktikhq/sdk-js für JavaScript und TypeScript oder pip install toktik für Python; beide rufen dieselbe v1-REST-API mit demselben Key und demselben Credit-Wallet auf. Die Docs-Seiten Quickstart und API Reference listen jeden Endpoint, Parameter und Scope.

Häufige Fragen

Wie viel kostet die Toktik-API?

Es gibt keine separate API-Preisliste. Die Web-App und die API verbrauchen im selben Tarif dasselbe Credit-Wallet. Eine Abfrage aus Toktiks Bestand kostet 1 Credit, ein Export kostet 2,500 Credits, und Aufrufe mit Erfassung auf Abruf kosten mehr.

Welche Rate Limits hat die Toktik-API?

Pro Key und Sekunde: Free 1, Starter 5, Pro 20, Scale 60 und Agency 150. Dazu gelten Tageskontingente, von 5,000 Requests bei Free bis 1,200,000 bei Agency. Wer das Limit überschreitet, erhält 429 mit Headern, die den Zustand des Fensters zeigen.

Hat Toktik offizielle SDKs?

Ja. @toktikhq/sdk-js deckt JavaScript und TypeScript ab, und das Paket toktik deckt Python ab. Beide rufen dieselbe v1-REST-API mit demselben Key auf.

Was ist der Unterschied zwischen 402 und 403 bei der Toktik-API?

Ein 402 bedeutet, dass dem Workspace die Credits ausgegangen sind, lade also auf, statt zu wiederholen. Ein 403 bedeutet, dass der Key gültig ist, ihm aber der nötige Scope fehlt; vergib ihn oder nutze eine angemeldete Sitzung. Ein 429 ist ein Rate Limit und kann nach kurzem Abwarten gefahrlos wiederholt werden.

API-Docs lesen Alle Ratgeber