Tekrarlanabilirlik anahtarlarının ve güvenli yeniden denemelerin test edilmesi

Zaman aşımına uğrayan bir POST isteği, istemci tasarımında en zor durumdur: istek başarılı olmuş olabilir ve bunu anlayamazsınız. İdempotans anahtarları, yeniden denemeyi güvenli hale getirerek bu sorunu çözer. Aşağıdaki API'ler bir Idempotency-Key başlığı kabul eder ve işi tekrar yapmak yerine orijinal yanıtı yeniden oynatır.

Bunu nasıl uygulayabilirsiniz?

1. Idempotency-Key ile kaynak oluşturun; aynı isteği tekrar gönderip aynı kimlik ve gövdeyi içeren ilk yanıtı aldığınızı doğrulayın.
2. Anahtarı koruyup gövdeyi değiştirin; API’nin uyuşmazlığı nasıl bildirdiğini inceleyin.
3. Aynı gövdeyi farklı anahtarla gönderin; iki ayrı kaynak oluştuğunu doğrulayın.
4. Bank API üzerinde aynı anahtarla tekrarlanan transferde bakiyenin yalnız bir kez değiştiğini doğrulayın.
5. Fault Injection API ile zaman aşımı oluşturun; aynı anahtarla yeniden deneyip son durumun doğru olduğunu kontrol edin.

Denemek için API'ler

• Arkadaşlar API'si — Characters, episodes & quotes from the coffee-house gang. (14 endpoints)
• Banka API'si — Accounts, transfers & cursor pagination. Home of the 402. (9 endpoints)
• Hata Enjeksiyonu API'si — Latency, status codes, malformed payloads & flaky responses. (5 endpoints)

İlgili durum kodları

• 200 Tamam
• 201 Created
• 409 Conflict

Diğer teknikler

• Sayfalama testi — Practise page-number and cursor pagination, and the edge cases that break clients: the last partial page, an out-of-range page, and a total count that disagrees with what you collected.
• Hız sınırlama testi — Trigger a real 429 with Retry-After and X-RateLimit headers, and verify your client backs off instead of retrying straight into the limit.
• ETag ve If-Match testleri— Provoke a 412 Precondition Failed by writing with a stale ETag — the check that stops two clients silently overwriting each other.
• Webhook imza testi — Register a callback, trigger a delivery, verify its HMAC signature, and confirm a tampered payload is rejected.
• OAuth ve JWT testleri — Run real client-credentials, authorization-code and device-code flows, then test what your client does when the token expires mid-session.
• Negatif test — Provoke 400, 401, 403, 404, 409, 418, 422, 429, 500 and 503 deliberately, and check your client handles each one differently.
• Asenkron iş testi— Start a long-running job, follow the 202 and its Location header, and poll to completion — including the failure and timeout paths.

Başlangıç rehberi · 39 mock REST API’nin tamamı

Son güncelleme 16 Ekim 2026