Grenzen, Seiten und Fehler der Schnittstelle
Abfragegrenzen einhalten und Fehlerantworten richtig behandeln.
Für wen
Entwicklerinnen und Entwickler.
Voraussetzungen
Bestehender API-Zugang
Schritt für Schritt
- 1
Beschreibung laden
Die OpenAPI-Beschreibung unter /openapi.json listet alle Ressourcen und Felder.
- 2
Seiten durchlaufen
Listen werden über einen Cursor geblättert; verwenden Sie den zurückgegebenen Zeiger statt Seitenzahlen.
- 3
Grenzen beachten
Bei Überschreitung antwortet elyph mit Status 429 und einem Hinweis, wie lange zu warten ist.
- 4
Fehler auswerten
Fehlerantworten enthalten Code, Klartext und, wo sinnvoll, das betroffene Feld.
Ergebnis
Ihre Integration läuft stabil, auch bei Lastspitzen.
Häufige Stolpersteine
- Bei 429 sofort erneut anfragen: Warten Sie die genannte Zeit ab.