CodingDesign idempotency

Add idempotency to a payment or write endpoint

Use to make a side-effecting endpoint safe to retry without double-charging or duplicating records.

The prompt
prompt.txt
You are a distributed systems engineer. I need to make this endpoint safe to retry.

Endpoint and what it does: {{endpoint_description}}
Side effects (charges, emails, rows created): {{side_effects}}
Datastore: {{datastore}}
Language/framework: {{language}}

Design an idempotency scheme:
1. How the client supplies an idempotency key and for how long it is valid.
2. The storage record (key, request fingerprint, status, cached response) and its constraints.
3. The concurrency-safe flow: first request vs duplicate vs in-flight retry vs key reuse with different payload.
4. Cleanup/expiry policy.
5. What happens on partial failure between the side effect and recording success.

Give the table DDL and pseudocode for the handler.

Click the copy button in the top right of the block to grab the full prompt.

Variables

Replace each placeholder below with your own values before you run the prompt.

  • {{endpoint_description}}
  • {{side_effects}}
  • {{datastore}}
  • {{language}}
Recommended models
Claude Opus 4.8GPT-5Gemini 2.5 Pro
Tags
#api#distributed-systems#idempotency#reliability

Related prompts

CodingExplain code
Explain unfamiliar code in plain English

You are a senior {{language}} engineer who is great at teaching. Explain the code below to a developer who knows programming basics but has never seen this codebase. Code: ```{{lan...

Claude Opus 4.xGPT-5Gemini 2.5 Pro
#explain#onboarding#comprehension#review
View
CodingRefactor code
Refactor a function for readability

Act as a meticulous code reviewer focused on readability and maintainability. Refactor this {{language}} code so it is easier to read and maintain, WITHOUT changing its observable...

Claude Opus 4.xGPT-5DeepSeek-V3
#refactor#readability#cleanup#maintainability
View
CodingDebug error
Debug from an error message and stack trace

You are an expert {{language}} debugger. Help me find the root cause, not just a quick patch. What I expected to happen: {{expected}} What actually happens: {{actual}} Error messag...

Claude Opus 4.xGPT-5Gemini 2.5 Pro
#debug#error#stacktrace#root-cause
View
CodingWrite tests
Write unit tests for a function

You write thorough, readable unit tests. Write unit tests for the following {{language}} code using {{framework}}. ```{{language}} {{code}} ``` Requirements: - Cover the happy path...

Claude Opus 4.xGPT-5DeepSeek-V3
#testing#unit-tests#coverage#quality
View
CodingReview PR
Review a pull request diff

Act as a senior engineer doing a careful pull request review. Be direct but constructive. Context (what this change is meant to do): {{context}} Diff: ```diff {{diff}} ``` Review f...

Claude Opus 4.xGPT-5Gemini 2.5 Pro
#review#pull-request#quality#security
View
CodingWrite regex
Build and explain a regular expression

You are a regex expert who writes patterns that are correct and maintainable. I need a regular expression for the {{flavor}} regex flavor that matches: {{requirement}} Examples tha...

Claude Opus 4.xGPT-5Gemini 2.5 Pro
#regex#pattern#parsing#strings
View

0 Comments

Sign in to post

Loading discussion...