Skip to content

Commit 44b6cff

Browse files
authored
Merge pull request #10 from sdatspun2/main
uses structured field issue #6
2 parents cdcc9ea + 979fca4 commit 44b6cff

File tree

1 file changed

+2
-9
lines changed

1 file changed

+2
-9
lines changed

draft-ietf-httpapi-idempotency-key-header.md

Lines changed: 2 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -65,20 +65,14 @@ An idempotency key is a unique value generated by the client which the resource
6565

6666
## Syntax
6767

68-
The `Idempotency-Key` request header field describes
6968

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`:
7070

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
7772

7873

7974
Clients MUST NOT include more than one `Idempotency-Key` header field in the same request.
8075

81-
8276
The following example shows an idempotency key using `UUID` {{!RFC4122}}:
8377

8478
Idempotency-Key: "8e03978e-40d5-43e8-bc93-6894a57f9324"
@@ -339,4 +333,3 @@ The rules below are defined in {{!RFC7230}}:
339333
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.
340334

341335
The authors take all responsibility for errors and omissions.
342-

0 commit comments

Comments
 (0)