Skip to content

Commit ce4966c

Browse files
authored
Merge pull request #411 from handrews/mtype
Name media type keywords consistently.
2 parents ab4b1a4 + 04006fe commit ce4966c

File tree

1 file changed

+17
-17
lines changed

1 file changed

+17
-17
lines changed

jsonschema-hyperschema.xml

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -429,10 +429,10 @@
429429
<section title="Submitting data for processing">
430430
<t>
431431
The <xref target="submissionSchema">"submissionSchema"</xref> and
432-
<xref target="submissionEncType">"submissionEncType"</xref> keywords
432+
<xref target="submissionMediaType">"submissionMediaType"</xref> keywords
433433
describe the domain of the processing function implemented by the target
434-
resource. Otherwise, as noted above, the submission schema and encoding are
435-
ignored for operations to which they are not relevant.
434+
resource. Otherwise, as noted above, the submission schema and media type
435+
are ignored for operations to which they are not relevant.
436436
</t>
437437
</section>
438438
</section>
@@ -1089,7 +1089,7 @@ GET /foo/
10891089
</section>
10901090
<section title="Security Considerations for &quot;targetSchema&quot;">
10911091
<t>
1092-
This property has similar security concerns to that of "mediaType".
1092+
This property has similar security concerns to that of "targetMediaType".
10931093
Clients MUST NOT use the value of this property to aid in the interpretation
10941094
of the data received in response to following the link, as this leaves
10951095
"safe" data open to re-interpretation.
@@ -1230,7 +1230,7 @@ GET /foo/
12301230
</section>
12311231
</section>
12321232

1233-
<section title="mediaType">
1233+
<section title="targetMediaType">
12341234
<t>
12351235
The value of this property is advisory only, and represents the media type
12361236
<xref target="RFC2046">RFC 2046</xref>, that is expected to be returned when
@@ -1278,15 +1278,15 @@ GET /foo/
12781278
}, {
12791279
"rel": "alternate",
12801280
"href": "/{id}/html",
1281-
"mediaType": "text/html"
1281+
"targetMediaType": "text/html"
12821282
}, {
12831283
"rel": "alternate",
12841284
"href": "/{id}/rss",
1285-
"mediaType": "application/rss+xml"
1285+
"targetMediaType": "application/rss+xml"
12861286
}, {
12871287
"rel": "icon",
12881288
"href": "{id}/icon",
1289-
"mediaType": "image/*"
1289+
"targetMediaType": "image/*"
12901290
}]
12911291
}
12921292
]]>
@@ -1318,18 +1318,18 @@ GET /foo/
13181318
feed, had it been displayed in the main view.
13191319
</t>
13201320

1321-
<section title="Security concerns for &quot;mediaType&quot;">
1321+
<section title="Security concerns for &quot;targetMediaType&quot;">
13221322
<t>
1323-
The "mediaType" property in link definitions defines the expected format of
1324-
the link's target.
1323+
The "targetMediaType" property in link definitions defines the expected
1324+
format of the link's target.
13251325
However, this is advisory only, and MUST NOT be considered authoritative.
13261326
</t>
13271327

13281328
<t>
13291329
When choosing how to interpret data, the type information provided by the
13301330
server (or inferred from the filename, or any other usual method) MUST be
1331-
the only consideration, and the "mediaType" property of the link MUST NOT be
1332-
used.
1331+
the only consideration, and the "targetMediaType" property of the link
1332+
MUST NOT be used.
13331333
User agents MAY use this information to determine how they represent the
13341334
link or where to display it (for example hover-text, opening in a new tab).
13351335
If user agents decide to pass the link to an external program, they SHOULD
@@ -1461,7 +1461,7 @@ GET /foo/
14611461
</section>
14621462
</section>
14631463

1464-
<section title="submissionEncType" anchor="submissionEncType">
1464+
<section title="submissionMediaType" anchor="submissionMediaType">
14651465
<t>
14661466
If present, this property indicates the media type format the
14671467
client should use for the request payload described by
@@ -1471,7 +1471,7 @@ GET /foo/
14711471
Omitting this keyword has the same behavior as a value of application/json.
14721472
</t>
14731473
<t>
1474-
Note that "submissionEncType" and "submissionSchema"
1474+
Note that "submissionMediaType" and "submissionSchema"
14751475
are not restricted to HTTP URIs.
14761476

14771477
<figure>
@@ -1484,7 +1484,7 @@ GET /foo/
14841484
<artwork>
14851485
<![CDATA[{
14861486
"links": [{
1487-
"submissionEncType": "multipart/alternative; boundary=ab12",
1487+
"submissionMediaType": "multipart/alternative; boundary=ab2",
14881488
"rel": "author",
14891489
"href": "mailto:[email protected]{?subject}",
14901490
"hrefSchema": {
@@ -1518,7 +1518,7 @@ GET /foo/
15181518
<section title="submissionSchema" anchor="submissionSchema">
15191519
<t>
15201520
This property contains a schema which defines the acceptable structure
1521-
of the document to be encoded according to the "submissionEncType" property
1521+
of the document to be encoded according to the "submissionMediaType" property
15221522
and sent to the target resource for processing. This can be viewed as
15231523
describing the domain of the processing function implemented by the
15241524
target resource.

0 commit comments

Comments
 (0)