You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: draft-ietf-httpapi-idempotency-key-header.md
+2-9Lines changed: 2 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -65,20 +65,14 @@ An idempotency key is a unique value generated by the client which the resource
65
65
66
66
## Syntax
67
67
68
-
The `Idempotency-Key` request header field describes
69
68
69
+
`Idempotency-Key` is an Item Structured Header {{!RFC8941}}. Its value MUST be a String. Refer to Section 3.3.3 of {{!RFC8941}} for ABNF of `sf-string`:
70
70
71
-
Idempotency-Key = idempotency-key-value
72
-
73
-
idempotency-key-value = opaque-value
74
-
opaque-value = DQUOTE *idempotencyvalue DQUOTE
75
-
idempotencyvalue = %x21 / %x23-7E / obs-text
76
-
; VCHAR except double quotes, plus obs-text
71
+
Idempotency-Key = sf-string
77
72
78
73
79
74
Clients MUST NOT include more than one `Idempotency-Key` header field in the same request.
80
75
81
-
82
76
The following example shows an idempotency key using `UUID` {{!RFC4122}}:
@@ -339,4 +333,3 @@ The rules below are defined in {{!RFC7230}}:
339
333
The authors would like to thank Mark Nottingham for his support for this Internet Draft. We would like to acknowledge that this draft is inspired by Idempotency related patterns described in API documentation of [PayPal](https://github.com/paypal/api-standards/blob/master/patterns.md#idempotency) and [Stripe](https://stripe.com/docs/idempotency) as well as Internet Draft on [POST Once Exactly](https://tools.ietf.org/html/draft-nottingham-http-poe-00) authored by Mark Nottingham.
340
334
341
335
The authors take all responsibility for errors and omissions.
0 commit comments