Why shouldn't I use a random UUID for idempotency keys?

A random UUID generated on every retry creates a new key for the same operation, defeating the purpose of deduplication. Keys should be deterministic based on request parameters or fixed client-side identifiers.

How does this handle race conditions?

The skill provides patterns for database-level unique constraints and atomic 'upsert' operations, ensuring that if two identical requests hit the server simultaneously, only one is processed.

Does this skill support FastAPI and Redis?

Yes, it includes specialized middleware patterns for FastAPI that leverage Redis for high-performance response caching and request deduplication.

What is an idempotency key?

An idempotency key is a unique identifier sent by a client that allows the server to recognize a repeated request. If the server sees the same key twice, it returns the cached response instead of executing the operation again.

Idempotency Patterns

Name: Idempotency Patterns
Author: yonatangross

byyonatangross

•

Desarrollo de API

Implements robust idempotency and deduplication patterns for APIs and distributed systems to ensure exactly-once execution.

This skill provides production-ready patterns for building reliable distributed systems where operations can be safely retried without side effects. It includes deterministic key generation logic, FastAPI middleware for request deduplication using Redis, database-backed idempotency for financial transactions, and event consumer patterns to handle at-least-once delivery semantics. It is essential for backend developers building payment systems, webhook handlers, and high-reliability microservices where data integrity and consistency are paramount.

Características Principales

0169 GitHub stars

02Database-backed persistence patterns using SQLAlchemy and PostgreSQL

03FastAPI middleware for automatic header-based request deduplication

04Exactly-once event processing logic for message queue consumers

05Distributed lock strategies to prevent race conditions during concurrent retries

06Deterministic idempotency key generation for consistent request tracking

Casos de Uso

01Ensuring safe mutation operations (POST, PUT, DELETE) in RESTful backend services

02Handling retries in webhook listeners and message queue consumers without side effects

03Preventing duplicate charges or refunds in financial and payment processing APIs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/orchestkit idempotency-patterns

For use in Claude.ai and ChatGPT

Download Skill