API-Übersicht

AllToken REST API Grundlagen — Authentifizierung, Base URL und Antwortformat.

Base URL

Base URL
$ https://api.alltoken.ai/v1

Alle API-Endpunkte sind relativ zu dieser Base URL. Die API ist vollständig kompatibel mit dem OpenAI-API-Format.

Authentifizierung

Alle Anfragen erfordern einen Bearer Token im Header Authorization:

Header
$ Authorization: Bearer YOUR_API_KEY

Ihren API-Schlüssel erhalten Sie unter Einstellungen → API-Schlüssel.

Antwortformat

Alle Antworten sind JSON. Erfolgreiche Antworten geben die Daten direkt zurück. Fehlerantworten haben folgendes Format:

Fehlerantwort
1{
2 "error": {
3 "message": "Invalid API key provided",
4 "type": "authentication_error",
5 "code": 401
6 }
7}

Statuscodes

  • 200 — Erfolg
  • 400 — Fehlerhafte Anfrage (ungültige Parameter)
  • 401 — Nicht autorisiert (API-Schlüssel ungültig oder fehlend)
  • 403 — Verboten (unzureichende Berechtigungen)
  • 404 — Ressource nicht gefunden
  • 429 — Ratenbegrenzung überschritten
  • 500 — Interner Serverfehler
  • 502/503 — Upstream-Anbieterfehler (kann automatisches Failover auslösen)