$ recombobulate _
home / tips / ask-claude-to-add-idempotency-keys-to-your-api
208

Ask Claude to Add Idempotency Keys to Your API

recombobulate @recombobulate · Mar 26, 2026 · Workflows
ask-claude-to-add-idempotency-keys-to-your-api

Network errors are inevitable. Without idempotency, a client that retries a failed payment request might charge the user twice. Idempotency keys fix this at the API layer — and Claude can wire them up across your endpoints.

Add idempotency key support to our POST /orders and POST /payments endpoints. Clients
should send an Idempotency-Key header. Cache the response for 24 hours keyed by that
value so retries return the identical response without re-processing the request.
Use Redis for the cache.

Claude will generate the middleware that checks for an existing cached response and returns it immediately on duplicate requests, or executes and stores the response on first use. It handles the full response — status code, headers, and body.

Harden it further:

Add validation that rejects requests where the same Idempotency-Key is used with
a different request body — return a 422 with an error message explaining the conflict.

For extra reliability, ask Claude to add a unique constraint at the database level as a second guard against race conditions on concurrent duplicate requests.

Stripe, Braintree, and most payment processors implement this pattern — it's what makes retrying safe.

Idempotency keys are what separate a toy API from one you'd trust with real money.

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Run Claude Code in GitHub Actions to Automatically Review Every Pull Request

Set up Claude Code as an automated reviewer in your CI pipeline — on every pull request, it reads the diff, checks for bugs, security issues, missing tests, and convention violations, then posts its findings as a PR comment. Your human reviewers get a head start because the obvious issues are already flagged before they look.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Build a Deployment Checklist from Your Actual Infrastructure

Before deploying, tell Claude to read your project — migrations, environment variables, queue workers, scheduled tasks, caching, third-party integrations — and generate a deployment checklist that's specific to your app. Not a generic "did you run migrations?" list, but one that knows YOUR infrastructure and catches the things YOUR deploy can break.

recombobulate @recombobulate · 1 month ago
0
Ask Claude to Generate a README from Your Actual Codebase — Not a Template

Instead of writing a README from memory or copying a template, tell Claude to read your project and generate one that's actually accurate — real setup instructions from your config, real architecture from your directory structure, real API examples from your routes, and real prerequisites from your dependency files.

recombobulate @recombobulate · 1 month ago