Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

idempotency-keys

/idempotency-keys

Implementuje klucze idempotencji, tak by powtórzone żądania dawały jeden efekt i jedną kanoniczną odpowiedź, w endpointach POST, zwłaszcza dla płatności i tworzenia zamówień.

Repozytorium
AI-SKILLS ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.09.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Implementuje klucze idempotencji, tak by powtórzone żądania dawały jeden efekt i jedną kanoniczną odpowiedź, w endpointach POST, zwłaszcza dla płatności i tworzenia zamówień.

Oryginalny opis (EN)

Implement idempotency keys so retried requests produce one effect and one canonical response. Use when making POST endpoints retry-safe, especially payments and order creation.

Jak działa

  1. Method
  2. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 325 słów
Podgląd SKILL.md
---
name: idempotency-keys
description: Implement idempotency keys so retried requests produce one effect and one canonical response. Use when making POST endpoints retry-safe, especially payments and order creation.
---

# Idempotency keys

A retry after a network timeout must not charge the card twice. The
client names the operation with a key; the server ensures one execution
and replays one recorded response.

## Method

1. **Client generates, server scopes.** Client sends
   `Idempotency-Key: <uuid>` per logical operation (same key on retry,
   new key for a genuinely new attempt). Server scopes stored keys by
   authenticated caller and endpoint so keys cannot collide across
   tenants or routes.
2. **Reserve the key atomically before doing work.** Insert
   `(key, scope, request_hash, status=in_progress)` with a unique
   constraint in the same database as your business data. Lost race =
   key exists: this is the whole mechanism; check-then-insert without
   the constraint is a duplicate generator under load.
3. **Bind the key to the request body.** Store a hash of the payload;
   same key + different hash returns 422. Otherwise a client bug replays
   order A's response to order B's request.
4. **Record the outcome, replay it verbatim.** On completion, store
   status code and response body against the key; any later duplicate
   gets exactly that response with an `Idempotent-Replay: true` header.
   Concurrent duplicate while in_progress: 409 with Retry-After, do not
   run the work twice in parallel.
5. **Choose the failure policy explicitly.** Recommended: store the
   error response for deterministic failures (validation) but clear the
   key on infrastructure failures so a retry can succeed. Document which
   you do; clients build their retry loops on it.
6. **Expire pragmatically.** 24-72h TTL covers real retry windows;
   sweep expired rows. An unbounded key table is a slow-motion outage.

## Boundaries

- GET/PUT/DELETE are idempotent by contract already; keys are for POST
  and other effectful non-idempotent operations.
- The key dedupes the request; it does not make your downstream calls
  safe. Inside the execution you still need transactional effects (see
  transactional-outbox).
- If the operation's effect happens outside your database (external
  charge API), execute it via that provider's own idempotency mechanism
  and store their reference before acking yours.

Wersje

W bazie nie ma innych skilli o nazwie idempotency-keys.

Migawka bazy z 13.11.2026 · wersja paczki 5d42a679cd0c (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90backend-idempotency
    Wdraża klucze idempotentności, by ponowienia żądań nie powodowały podwójnych skutków, np. dwóch obciążeń tej samej płatności.
  • 100idempotency-patterns
    Zabezpiecza ponawiane polecenia HTTP i przetwarzanie komunikatów przed zdublowanymi skutkami: klucze żądań w bazie, konflikty ładunku i równoległe ponowienia.
  • 100idempotency-patterns
    Zabezpiecza ponawiane polecenia HTTP i przetwarzanie komunikatów przed zdublowanymi skutkami: klucze żądań w bazie, konflikty ładunku i równoległe ponowienia.
  • 90idempotency-and-retries
    Zapewnia bezpieczne powtarzanie operacji: klucze idempotencji i ich przechowywanie, odpowiedź na powtórkę, ponowienia z backoffem i jitterem oraz uzgadnianie po przekroczeniu czasu z nieznanym wynikiem.
  • 100idempotent-apis
    Projektuje i przegląda idempotentne endpointy HTTP zmieniające stan: klucze idempotencji, deduplikacja żądań, bezpieczne ponowienia i wzorzec Stripe, gdy endpoint tworzy zasoby, pobiera płatności lub wysyła powiadomienia.
  • 100idempotency-handling
    Implementuje idempotentne operacje API z kluczami idempotentności, cache w Redis i ograniczeniami w bazie danych, dla płatności, ponowień webhooków i problemów z podwójnym przetwarzaniem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.