Orqestria Download
← Zurück zu Vollständiger Ablauf

Skill · Version 1.0.0

API-Integrationen prüfen

Testet Dienstgrenzen mit ungültigen Eingaben, parallelen Anfragen und Teilausfällen auf widersprüchliche oder doppelte Ergebnisse.

api-integration-qa

Workflow-Agenten mit diesem Skill

Entdecke, wie der Skill hilft

Wann ist der Skill hilfreich?

Nutze dies, wenn mehrere Dienste kommunizieren und Fehler Arbeit blockieren oder doppelt ausführen könnten.

Wobei hilft er dir?

  • Testet fehlerhafte Nutzdaten und ungültige Abfrageparameter direkt an der API.
  • Prüft wiederholte Anfragen und alte Versionen auf doppelte Effekte oder verlorene Änderungen.
  • Untersucht stabile Seitennavigation, Zeitüberschreitungen und unterbrochene Streams zwischen Diensten.

Das könntest du fragen

Teste eine Bestell-API mit doppelten Übermittlungen, gleichzeitigen Änderungen und einem Timeout beim Zahlungsanbieter. Prüfe nach jedem Versuch gespeicherte Bestell- und Zahlungsdaten. Wiederholungen dürfen keine Doppelbelastung und veraltete Bearbeitungen keinen Datenverlust verursachen.

Ausführliche Dokumentation

Hier findest du die ursprüngliche Anleitung, Beispiele und Prüfschritte des Skills in ihrer Originalsprache.

Details…Weniger anzeigen

API & Integration QA

Use this skill when testing backend endpoints, client-server contracts, webhooks, and external service integrations to ensure invalid inputs, retries, and partial failures are handled safely.

Workflow

  1. Verify request validation and contract enforcement:
    • Do not test only through the frontend UI, which may block invalid inputs client-side. Test API contracts directly with:
      • Missing required fields, unexpected extra fields, wrong data types ("123" vs 123, null, {}), and oversized payloads.
      • Invalid Content-Type headers, malformed JSON, and out-of-range query parameters (limit=-1, limit=999999, invalid cursor/UUID).
    • Confirm that the API returns structured, documented 4xx domain errors (400, 401, 403, 404, 409, 422) without leaking stack traces, SQL queries, or internal paths.
  2. Test idempotency, retries, and concurrency:
    • Replay POST / PATCH / DELETE requests with the same Idempotency-Key or duplicate webhook delivery ID and verify the operation executes once without duplicating records or side effects.
    • Test optimistic concurrency (expectedVersion / ETag) so stale updates fail cleanly with 409 Conflict rather than silently overwriting newer changes.
  3. Test pagination, filtering, and sorting:
    • Verify stable ordering when items share identical timestamps.
    • Check boundary pages (empty result [], page 1, last page, and when an item is inserted or deleted between page fetches).
  4. Test upstream timeouts and partial failures:
    • Verify how the system behaves when an external API, LLM provider, or queue worker returns 429 Too Many Requests, 502/503/504, or disconnects mid-stream:
      • Does the system surface a clear status and allow safe retry/recovery without leaving stuck 'running' or 'pending' state?

Enthaltene Dateien 1

  • SKILL.md