Schnittstelle für Entwickler

Gamma nutzt selbst dieselbe Schnittstelle, die auch dir offensteht. Sie ist bei fairer Nutzung kostenlos.

Beschreibung

Alle Endpunkte mit Eingaben und Anmeldung stehen im OpenAPI-Dokument: /api/v1/openapi.json

Anmeldung

Öffentliche Inhalte liest du ohne Konto. Zum Schreiben legst du in deinem Konto ein API-Token an (höchstens 10) und schickst es im Header mit. Im Adressteil wird ein Token nie angenommen.

Tokens verwalten und das Konto löschen geht nur angemeldet im Browser.

Grenzen

Je Token 600 Lese- und 120 Schreibanfragen pro Minute, dazu Grenzen je Adresse und für einzelne Aktionen. Darüber antwortet die Schnittstelle mit 429 und nennt die Wartezeit im Header Retry-After.

Fehler

Fehler kommen immer im selben Format, bei ungültigen Eingaben mit HTTP 422 und Angabe des Felds:

{
  "error": {
    "code": "validation_failed",
    "message": "Eingaben sind ungültig.",
    "details": [
      {
        "field": "title",
        "message": "Der Titel fehlt."
      }
    ]
  }
}