Skip to main content

A plain-English guide

Idempotency

Designing a request so that repeating it does not create the same intended result more than once.

What it means in practice

A system may attach a unique key to an action and recognize later attempts using the same key. This is separate from refusing all retries: retries can be necessary when a network response is lost even though the original action succeeded.

An everyday example

A checkout request times out after an order is accepted. Retrying with the same action identity lets the system return the existing outcome instead of creating a second order.

Why it matters

Connections sometimes retry after a timeout. A safe retry should not create a duplicate payment, order or customer action.

Your preferences

Privacy choices

Choose which optional services can run on this website. Everything optional stays off until you choose. You can change your settings at any time.

Advertising tags are not configured on this website. These settings apply to this browser on this website; platform and ordering accounts have their own choices.

Make yourself comfortable

Accessibility

Choose what makes this page comfortable. Preferences stay on this device.

Navigate this page

Keyboard shortcuts

On a Mac, Alt is the Option key. Shortcuts do not run while you’re typing in a field, or with Control or Command held.

Alt + Shift + A
Open accessibility tools
Alt + Shift + S
Navigate by page structure
Alt + Shift + ?
Show keyboard shortcuts
Alt + Shift + T
Text size: next size
Alt + Shift + C
Contrast: next level
Alt + Shift + F
Focus outline on or off
Alt + Shift + L
Highlight links on or off
Alt + Shift + H
Highlight headings on or off
Alt + Shift + M
Stop animation on or off
Alt + Shift + G
Reading guide on or off
Alt + Shift + R
Reset everything

Policies & Choices

Open Page →