← Kis feladat adatlapja
Nézd meg, miben segít
API-integrációk ellenőrzése
Hibás bemenettel, átfedő kéréssel és részleges kieséssel keresi a szolgáltatáshatárok következetlen vagy megkettőzött eredményeit.
api-integration-qa
Ezt a skillt használó ügynökök
Mikor hasznos?
Akkor használd, ha több szolgáltatás kommunikál, és hiba esetén beragadt vagy megkettőzött munka keletkezhet.
Miben segít neked?
- Közvetlen API-kérésekkel teszteli a hibás adatokat és érvénytelen lekérdezési paramétereket.
- Vizsgálja az ismételt kérések és elavult verziók okozta kettős hatást vagy elvesző módosítást.
- Ellenőrzi a stabil lapozást, szolgáltatói időtúllépést és megszakadó adatfolyamot.
Például ezt kérheted
Teszteld a rendelési API-t dupla beküldéssel, párhuzamos szerkesztéssel és fizetési szolgáltatói időtúllépéssel. Minden próbálkozás után nézd meg a mentett rendelést és fizetést. Az újrapróbálás ne duplázzon terhelést, a régi szerkesztés ne írja felül az újabbat.
Részletes dokumentáció
Itt a skill eredeti útmutatóját, példáit és ellenőrzési szempontjait olvashatod az eredeti nyelven.
Összecsukás
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
- 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"vs123,null,{}), and oversized payloads. - Invalid Content-Type headers, malformed JSON, and out-of-range query parameters (
limit=-1,limit=999999, invalid cursor/UUID).
- Missing required fields, unexpected extra fields, wrong data types (
- 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.
- Do not test only through the frontend UI, which may block invalid inputs client-side. Test API contracts directly with:
- Test idempotency, retries, and concurrency:
- Replay
POST/PATCH/DELETErequests with the sameIdempotency-Keyor 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 with409 Conflictrather than silently overwriting newer changes.
- Replay
- 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).
- 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?
- Does the system surface a clear status and allow safe retry/recovery without leaving stuck
- Verify how the system behaves when an external API, LLM provider, or queue worker returns
Csomagban lévő fájlok 1
SKILL.md
