Skip to content

Commit 6a87162

Browse files
committed
Add clarification for media type
All media types declared with IANA registered the same subtype. This commit addresses it. In addition, this commit makes the Content-Type for request and responses normative with `MUST be`. Closes ietf-wg-privacypass#33
1 parent fa9a71a commit 6a87162

File tree

1 file changed

+16
-12
lines changed

1 file changed

+16
-12
lines changed

Diff for: draft-ietf-privacypass-batched-tokens.md

+16-12
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ The structure fields are defined as follows:
222222

223223
The Client then generates an HTTP POST request to send to the Issuer Request
224224
URL, with the BatchTokenRequest as the content. The media type for this request
225-
is "application/private-token-privately-verifiable-batch-request". An example
225+
MUST be "application/private-token-privately-verifiable-batch-request". An example
226226
request for the Issuer Request URL "https://issuer.example.net/request" is shown
227227
below.
228228

@@ -324,7 +324,7 @@ The structure fields are defined as follows:
324324
Scalar values, computed as `concat(SerializeScalar(proof[0]),
325325
SerializeScalar(proof[1]))`, where Ns is as defined in {{OPRF, Section 4}}.
326326

327-
The Issuer generates an HTTP response with status code 200 whose content
327+
The Issuer MUST generate an HTTP response with status code 200 whose content
328328
consists of TokenResponse, with the content type set as
329329
"application/private-token-privately-verifiable-batch-response".
330330

@@ -456,7 +456,7 @@ The structure fields are defined as follows:
456456

457457
The Client then generates an HTTP POST request to send to the Issuer Request
458458
URL, with the BatchTokenRequest as the content. The media type for this request
459-
is "application/private-token-arbitrary-batch-request". An example request for
459+
MUST be "application/private-token-arbitrary-batch-request". An example request for
460460
the Issuer Request URL "https://issuer.example.net/request" is shown below.
461461

462462
~~~
@@ -509,7 +509,7 @@ prefixed with two bytes. OptionalTokenResponse.token_response is a
509509
length-prefix-encoded TokenResponse, where a length of 0 indicates that the
510510
Issuer failed or refused to issue the associated TokenRequest.
511511

512-
The Issuer generates an HTTP response with status code 200 whose content
512+
The Issuer MUST generate an HTTP response with status code 200 whose content
513513
consists of TokenResponse, with the content type set as
514514
"application/private-token-arbitrary-batch-response".
515515

@@ -592,7 +592,7 @@ Type name:
592592

593593
Subtype name:
594594

595-
: private-token-request
595+
: private-token-privately-verifiable-batch-request
596596

597597
Required parameters:
598598

@@ -620,7 +620,8 @@ Published specification:
620620

621621
Applications that use this media type:
622622

623-
: Applications that want to issue or facilitate issuance of Privacy Pass tokens,
623+
: Applications that want to issue or facilitate issuance of Privacy Pass
624+
Batched Privately Verifiable tokens as defined in {{batched-private}},
624625
including Privacy Pass issuer applications themselves.
625626

626627
Fragment identifier considerations:
@@ -665,7 +666,7 @@ Type name:
665666

666667
Subtype name:
667668

668-
: private-token-response
669+
: private-token-privately-verifiable-batch-response
669670

670671
Required parameters:
671672

@@ -693,7 +694,8 @@ Published specification:
693694

694695
Applications that use this media type:
695696

696-
: Applications that want to issue or facilitate issuance of Privacy Pass tokens,
697+
: Applications that want to issue or facilitate issuance of Privacy Pass
698+
Batched Privately Verifiable tokens as defined in {{batched-private}},
697699
including Privacy Pass issuer applications themselves.
698700

699701
Fragment identifier considerations:
@@ -738,7 +740,7 @@ Type name:
738740

739741
Subtype name:
740742

741-
: private-token-request
743+
: private-token-arbitrary-batch-request
742744

743745
Required parameters:
744746

@@ -766,7 +768,8 @@ Published specification:
766768

767769
Applications that use this media type:
768770

769-
: Applications that want to issue or facilitate issuance of Privacy Pass tokens,
771+
: Applications that want to issue or facilitate issuance of Privacy Pass
772+
Arbitrary Batched tokens as defined in {{batched-arbitrary}},
770773
including Privacy Pass issuer applications themselves.
771774

772775
Fragment identifier considerations:
@@ -811,7 +814,7 @@ Type name:
811814

812815
Subtype name:
813816

814-
: private-token-response
817+
: private-token-arbitrary-batch-response
815818

816819
Required parameters:
817820

@@ -839,7 +842,8 @@ Published specification:
839842

840843
Applications that use this media type:
841844

842-
: Applications that want to issue or facilitate issuance of Privacy Pass tokens,
845+
: Applications that want to issue or facilitate issuance of Privacy Pass
846+
Arbitrary Batched tokens as defined in {{batched-arbitrary}},
843847
including Privacy Pass issuer applications themselves.
844848

845849
Fragment identifier considerations:

0 commit comments

Comments
 (0)