Testen der Paginierung anhand einer realen API

Die Paginierung erscheint trivial, bis eine Seitengrenze mitten in einem Datensatz landet, der noch beschrieben wird. Die folgenden APIs implementieren beide gängigen Stile – Seitenzahlen mit Summe und undurchsichtige Cursor – sodass Sie für jeden einen Client schreiben und herausfinden können, welche Annahmen Ihr Code trifft.

Wie man es übt

1. Rufen Sie alle Seiten ab und prüfen Sie, ob die Anzahl der gesammelten Datensätze der gemeldeten Gesamtzahl entspricht.
2. Fordern Sie eine Seite hinter dem Ende an. Manche APIs antworten mit einer leeren Liste und 200, die Friends-API mit 404. Der Client muss beide Varianten behandeln können.
3. Prüfen Sie die letzte, meist nur teilweise gefüllte Seite auf Fehler an den Datensatzgrenzen.
4. Durchlaufen Sie die Bank-API mit einem Cursor und prüfen Sie, dass keine Datensätze fehlen oder doppelt erscheinen.
5. Kombinieren Sie Paginierung und Filter und prüfen Sie die Anzahlen erneut.

APIs, um es auszuprobieren

• Friends API — Characters, episodes & quotes from the coffee-house gang. (14 endpoints)
• Star Wars API — Characters, planets & starships from a galaxy far away. (11 endpoints)
• Bank-API — Accounts, transfers & cursor pagination. Home of the 402. (9 endpoints)
• Such- und Facetten-API — Full-text queries, facets, highlights & cursor pagination. (2 endpoints)

Betroffene Statuscodes

• 200 OK
• 400 Bad Request
• 404 Not Found

Andere Techniken

• API-Ratenbegrenzung testen — Trigger a real 429 with Retry-After and X-RateLimit headers, and verify your client backs off instead of retrying straight into the limit.
• Idempotenz-Schlüsseltest— Send the same write twice with an Idempotency-Key and confirm the operation happens once — the mechanism that stops a network retry becoming a duplicate charge.
• ETag- und If-Match-Test— Provoke a 412 Precondition Failed by writing with a stale ETag — the check that stops two clients silently overwriting each other.
• Webhook-Signaturprüfung — Register a callback, trigger a delivery, verify its HMAC signature, and confirm a tampered payload is rejected.
• OAuth- und JWT-Tests — Run real client-credentials, authorization-code and device-code flows, then test what your client does when the token expires mid-session.
• Negativer Test — Provoke 400, 401, 403, 404, 409, 418, 422, 429, 500 and 503 deliberately, and check your client handles each one differently.
• Asynchrone Jobtests— Start a long-running job, follow the 202 and its Location header, and poll to completion — including the failure and timeout paths.

Einstiegsanleitung · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert 16. Oktober 2026