|
449 | 449 | <link href="#rfc.authors" rel="Chapter">
|
450 | 450 |
|
451 | 451 |
|
452 |
| - <meta name="generator" content="xml2rfc version 2.22.3 - https://tools.ietf.org/tools/xml2rfc" /> |
| 452 | + <meta name="generator" content="xml2rfc version 2.20.1 - https://tools.ietf.org/tools/xml2rfc" /> |
453 | 453 | <link rel="schema.dct" href="http://purl.org/dc/terms/" />
|
454 | 454 |
|
455 | 455 | <meta name="dct.creator" content="Andrews, H., Ed. and A. Wright, Ed." />
|
456 |
| - <meta name="dct.identifier" content="urn:ietf:id:draft-handrews-json-schema-hyperschema-WIP" /> |
457 |
| - <meta name="dct.issued" scheme="ISO8601" content="2019-18" /> |
| 456 | + <meta name="dct.identifier" content="urn:ietf:id:draft-handrews-json-schema-hyperschema-02" /> |
| 457 | + <meta name="dct.issued" scheme="ISO8601" content="2019-10" /> |
458 | 458 | <meta name="dct.abstract" content="JSON Schema is a JSON-based format for describing JSON data using various vocabularies. This document specifies a vocabulary for annotating JSON documents with hyperlinks. These hyperlinks include attributes describing how to manipulate and interact with remote resources through hypermedia environments such as HTTP, as well as determining whether the link is usable based on the instance value. The hyperlink serialization format described in this document is also usable independent of JSON Schema. " />
|
459 | 459 | <meta name="description" content="JSON Schema is a JSON-based format for describing JSON data using various vocabularies. This document specifies a vocabulary for annotating JSON documents with hyperlinks. These hyperlinks include attributes describing how to manipulate and interact with remote resources through hypermedia environments such as HTTP, as well as determining whether the link is usable based on the instance value. The hyperlink serialization format described in this document is also usable independent of JSON Schema. " />
|
460 | 460 |
|
|
471 | 471 | </tr>
|
472 | 472 | <tr>
|
473 | 473 | <td class="left">Internet-Draft</td>
|
474 |
| -<td class="right">Riverbed Technology</td> |
| 474 | +<td class="right"></td> |
475 | 475 | </tr>
|
476 | 476 | <tr>
|
477 | 477 | <td class="left">Intended status: Informational</td>
|
478 | 478 | <td class="right">A. Wright, Ed.</td>
|
479 | 479 | </tr>
|
480 | 480 | <tr>
|
481 |
| -<td class="left">Expires: December 20, 2019</td> |
482 |
| -<td class="right">June 18, 2019</td> |
| 481 | +<td class="left">Expires: February 11, 2020</td> |
| 482 | +<td class="right">August 10, 2019</td> |
483 | 483 | </tr>
|
484 | 484 |
|
485 | 485 |
|
486 | 486 | </tbody>
|
487 | 487 | </table>
|
488 | 488 |
|
489 | 489 | <p class="title">JSON Hyper-Schema: A Vocabulary for Hypermedia Annotation of JSON <br />
|
490 |
| - <span class="filename">draft-handrews-json-schema-hyperschema-WIP</span></p> |
| 490 | + <span class="filename">draft-handrews-json-schema-hyperschema-02</span></p> |
491 | 491 |
|
492 | 492 | <h1 id="rfc.abstract"><a href="#rfc.abstract">Abstract</a></h1>
|
493 | 493 | <p>JSON Schema is a JSON-based format for describing JSON data using various vocabularies. This document specifies a vocabulary for annotating JSON documents with hyperlinks. These hyperlinks include attributes describing how to manipulate and interact with remote resources through hypermedia environments such as HTTP, as well as determining whether the link is usable based on the instance value. The hyperlink serialization format described in this document is also usable independent of JSON Schema. </p>
|
494 | 494 | <h1><a>Note to Readers</a></h1>
|
495 | 495 | <p>The issues list for this draft can be found at <span><</span><a href="https://github.com/json-schema-org/json-schema-spec/issues">https://github.com/json-schema-org/json-schema-spec/issues</a><span>></span>. </p>
|
496 |
| -<p>For additional information, see <span><</span><a href="http://json-schema.org/">http://json-schema.org/</a><span>></span>. </p> |
| 496 | +<p>For additional information, see <span><</span><a href="https://json-schema.org/">https://json-schema.org/</a><span>></span>. </p> |
497 | 497 | <p>To provide feedback, use this issue tracker, the communication methods listed on the homepage, or email the document editors. </p>
|
498 | 498 | <h1 id="rfc.status"><a href="#rfc.status">Status of This Memo</a></h1>
|
499 | 499 | <p>This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.</p>
|
500 | 500 | <p>Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.</p>
|
501 | 501 | <p>Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."</p>
|
502 |
| -<p>This Internet-Draft will expire on December 20, 2019.</p> |
| 502 | +<p>This Internet-Draft will expire on February 11, 2020.</p> |
503 | 503 | <h1 id="rfc.copyrightnotice"><a href="#rfc.copyrightnotice">Copyright Notice</a></h1>
|
504 | 504 | <p>Copyright (c) 2019 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
|
505 | 505 | <p>This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.</p>
|
@@ -727,11 +727,11 @@ <h1 id="rfc.section.3.2">
|
727 | 727 | <p id="rfc.section.3.2.p.4">A few IANA-registered link relation types are given specific semantics in a JSON Hyper-Schema document. A "self" link is used to interact with the resource that the instance document represents, while "collection" and "item" links identify resources for which collection-specific semantics can be assumed. </p>
|
728 | 728 | <h1 id="rfc.section.4">
|
729 | 729 | <a href="#rfc.section.4">4.</a> Meta-Schemas and Output Schema</h1>
|
730 |
| -<p id="rfc.section.4.p.1">The current URI for the JSON Hyper-Schema meta-schema is <span><</span><a href="http://json-schema.org/draft/2019-04/hyper-schema#">http://json-schema.org/draft/2019-04/hyper-schema#</a><span>></span>. </p> |
731 |
| -<p id="rfc.section.4.p.2">The current URI for this vocabulary, known as the Hyper-Schema vocabulary, is: <span><</span><a href="https://json-schema.org/draft/2019-04/vocab/hyper-schema">https://json-schema.org/draft/2019-04/vocab/hyper-schema</a><span>></span>. </p> |
732 |
| -<p id="rfc.section.4.p.3">The current URI for the corresponding meta-schema, which differs from the convenience meta-schema above in that it describes only the hyper-schema keywords ("base" and "link") is: <span><</span><a href="https://json-schema.org/draft/2019-04/meta/hyper-schema">https://json-schema.org/draft/2019-04/meta/hyper-schema</a><span>></span>. </p> |
733 |
| -<p id="rfc.section.4.p.4">The <a href="#ldo" class="xref">link description format</a> can be used without JSON Schema, and use of this format can be declared by referencing the normative link description schema as the schema for the data structure that uses the links. The URI of the normative link description schema is: <span><</span><a href="http://json-schema.org/draft/2019-04/links#">http://json-schema.org/draft/2019-04/links#</a><span>></span>. </p> |
734 |
| -<p id="rfc.section.4.p.5">JSON Hyper-Schema implementations are free to provide output in any format. However, a specific format is defined for use in the conformance test suite, which is also used to illustrate points in the <a href="#implementation" class="xref">"Implementation Requirements"</a>, and to show the output generated by <a href="#examples" class="xref">examples</a>. It is RECOMMENDED that implementations be capable of producing output in this format to facilitated testing. The URI of the JSON Schema describing the recommended output format is <span><</span><a href="http://json-schema.org/draft/2019-04/output/hyper-schema#">http://json-schema.org/draft/2019-04/output/hyper-schema#</a><span>></span>. </p> |
| 730 | +<p id="rfc.section.4.p.1">The current URI for the JSON Hyper-Schema meta-schema is <span><</span><a href="https://json-schema.org/draft/2019-08/hyper-schema#">https://json-schema.org/draft/2019-08/hyper-schema#</a><span>></span>. </p> |
| 731 | +<p id="rfc.section.4.p.2">The current URI for this vocabulary, known as the Hyper-Schema vocabulary, is: <span><</span><a href="https://json-schema.org/draft/2019-08/vocab/hyper-schema">https://json-schema.org/draft/2019-08/vocab/hyper-schema</a><span>></span>. </p> |
| 732 | +<p id="rfc.section.4.p.3">The current URI for the corresponding meta-schema, which differs from the convenience meta-schema above in that it describes only the hyper-schema keywords ("base" and "link") is: <span><</span><a href="https://json-schema.org/draft/2019-08/meta/hyper-schema">https://json-schema.org/draft/2019-08/meta/hyper-schema</a><span>></span>. </p> |
| 733 | +<p id="rfc.section.4.p.4">The <a href="#ldo" class="xref">link description format</a> can be used without JSON Schema, and use of this format can be declared by referencing the normative link description schema as the schema for the data structure that uses the links. The URI of the normative link description schema is: <span><</span><a href="https://json-schema.org/draft/2019-08/links#">https://json-schema.org/draft/2019-08/links#</a><span>></span>. </p> |
| 734 | +<p id="rfc.section.4.p.5">JSON Hyper-Schema implementations are free to provide output in any format. However, a specific format is defined for use in the conformance test suite, which is also used to illustrate points in the <a href="#implementation" class="xref">"Implementation Requirements"</a>, and to show the output generated by <a href="#examples" class="xref">examples</a>. It is RECOMMENDED that implementations be capable of producing output in this format to facilitated testing. The URI of the JSON Schema describing the recommended output format is <span><</span><a href="https://json-schema.org/draft/2019-08/output/hyper-schema#">https://json-schema.org/draft/2019-08/output/hyper-schema#</a><span>></span>. </p> |
735 | 735 | <p id="rfc.section.4.p.6">Updated vocabulary and meta-schema URIs MAY be published between specification drafts in order to correct errors. Implementations SHOULD consider URIs dated after this specification draft and before the next to indicate the same syntax and semantics as those listed here. </p>
|
736 | 736 | <h1 id="rfc.section.5">
|
737 | 737 | <a href="#rfc.section.5">5.</a> Schema Keywords</h1>
|
@@ -1189,7 +1189,7 @@ <h1 id="rfc.section.9.1">
|
1189 | 1189 |
|
1190 | 1190 | {
|
1191 | 1191 | "$id": "https://schema.example.com/entry",
|
1192 |
| - "$schema": "http://json-schema.org/draft/2019-04/hyper-schema#", |
| 1192 | + "$schema": "https://json-schema.org/draft/2019-08/hyper-schema#", |
1193 | 1193 | "base": "https://example.com/api/",
|
1194 | 1194 | "links": [
|
1195 | 1195 | {
|
@@ -1231,7 +1231,7 @@ <h1 id="rfc.section.9.2">
|
1231 | 1231 | <pre>
|
1232 | 1232 | {
|
1233 | 1233 | "$id": "https://schema.example.com/thing",
|
1234 |
| - "$schema": "http://json-schema.org/draft/2019-04/hyper-schema#", |
| 1234 | + "$schema": "https://json-schema.org/draft/2019-08/hyper-schema#", |
1235 | 1235 | "base": "https://example.com/api/",
|
1236 | 1236 | "type": "object",
|
1237 | 1237 | "required": ["data"],
|
@@ -1285,7 +1285,7 @@ <h1 id="rfc.section.9.3">
|
1285 | 1285 | <pre>
|
1286 | 1286 | {
|
1287 | 1287 | "$id": "https://schema.example.com/interesting-stuff",
|
1288 |
| - "$schema": "http://json-schema.org/draft/2019-04/hyper-schema#", |
| 1288 | + "$schema": "https://json-schema.org/draft/2019-08/hyper-schema#", |
1289 | 1289 | "required": ["stuffWorthEmailingAbout", "email", "title"],
|
1290 | 1290 | "properties": {
|
1291 | 1291 | "title": {
|
@@ -1413,7 +1413,7 @@ <h1 id="rfc.section.9.4">
|
1413 | 1413 | <pre>
|
1414 | 1414 | {
|
1415 | 1415 | "$id": "https://schema.example.com/tree-node",
|
1416 |
| - "$schema": "http://json-schema.org/draft/2019-04/hyper-schema#", |
| 1416 | + "$schema": "https://json-schema.org/draft/2019-08/hyper-schema#", |
1417 | 1417 | "base": "trees/{treeId}/",
|
1418 | 1418 | "properties": {
|
1419 | 1419 | "id": {"type": "integer"},
|
@@ -1453,7 +1453,7 @@ <h1 id="rfc.section.9.5">
|
1453 | 1453 | <pre>
|
1454 | 1454 | {
|
1455 | 1455 | "$id": "https://schema.example.com/thing",
|
1456 |
| - "$schema": "http://json-schema.org/draft/2019-04/hyper-schema#", |
| 1456 | + "$schema": "https://json-schema.org/draft/2019-08/hyper-schema#", |
1457 | 1457 | "base": "https://example.com/api/",
|
1458 | 1458 | "type": "object",
|
1459 | 1459 | "required": ["data"],
|
@@ -1488,7 +1488,7 @@ <h1 id="rfc.section.9.5">
|
1488 | 1488 | <pre>
|
1489 | 1489 | {
|
1490 | 1490 | "$id": "https://schema.example.com/thing-collection",
|
1491 |
| - "$schema": "http://json-schema.org/draft/2019-04/hyper-schema#", |
| 1491 | + "$schema": "https://json-schema.org/draft/2019-08/hyper-schema#", |
1492 | 1492 | "base": "https://example.com/api/",
|
1493 | 1493 | "type": "object",
|
1494 | 1494 | "required": ["elements"],
|
@@ -1751,12 +1751,12 @@ <h1 id="rfc.references.1">
|
1751 | 1751 | <tr>
|
1752 | 1752 | <td class="reference"><b id="json-schema">[json-schema]</b></td>
|
1753 | 1753 | <td class="top">
|
1754 |
| -<a>Wright, A.</a> and <a>H. Andrews</a>, "<a href="https://tools.ietf.org/html/draft-handrews-json-schema-02">JSON Schema: A Media Type for Describing JSON Documents</a>", Internet-Draft draft-handrews-json-schema-WIP, November 2017.</td> |
| 1754 | +<a>Wright, A.</a> and <a>H. Andrews</a>, "<a href="https://tools.ietf.org/html/draft-handrews-json-schema-02">JSON Schema: A Media Type for Describing JSON Documents</a>", Internet-Draft draft-handrews-json-schema-02, November 2017.</td> |
1755 | 1755 | </tr>
|
1756 | 1756 | <tr>
|
1757 | 1757 | <td class="reference"><b id="json-schema-validation">[json-schema-validation]</b></td>
|
1758 | 1758 | <td class="top">
|
1759 |
| -<a>Wright, A.</a>, <a>Andrews, H.</a> and <a>G. Luff</a>, "<a href="https://tools.ietf.org/html/draft-handrews-json-schema-validation-02">JSON Schema Validation: A Vocabulary for Structural Validation of JSON</a>", Internet-Draft draft-handrews-json-schema-validation-WIP, November 2017.</td> |
| 1759 | +<a>Wright, A.</a>, <a>Andrews, H.</a> and <a>G. Luff</a>, "<a href="https://tools.ietf.org/html/draft-handrews-json-schema-validation-02">JSON Schema Validation: A Vocabulary for Structural Validation of JSON</a>", Internet-Draft draft-handrews-json-schema-validation-02, November 2017.</td> |
1760 | 1760 | </tr>
|
1761 | 1761 | <tr>
|
1762 | 1762 | <td class="reference"><b id="relative-json-pointer">[relative-json-pointer]</b></td>
|
@@ -1868,7 +1868,7 @@ <h1 id="rfc.appendix.B">
|
1868 | 1868 | <p></p>
|
1869 | 1869 |
|
1870 | 1870 | <dl>
|
1871 |
| -<dt>draft-handrews-json-schema-hyperschema-WIP</dt> |
| 1871 | +<dt>draft-handrews-json-schema-hyperschema-02</dt> |
1872 | 1872 | <dd style="margin-left: 8">
|
1873 | 1873 | <ul>
|
1874 | 1874 | <li>Allow multiple values for "rel"</li>
|
@@ -1968,18 +1968,17 @@ <h1 id="rfc.authors"><a href="#rfc.authors">Authors' Addresses</a></h1>
|
1968 | 1968 | <span class="family-name">Andrews</span>
|
1969 | 1969 | </span>
|
1970 | 1970 | </span>
|
1971 |
| - <span class="org vcardline">Riverbed Technology</span> |
| 1971 | + <span class="org vcardline"></span> |
1972 | 1972 | <span class="adr">
|
1973 |
| - <span class="vcardline">680 Folsom St.</span> |
1974 |
| - |
| 1973 | + |
1975 | 1974 | <span class="vcardline">
|
1976 |
| - <span class="locality">San Francisco</span>, |
1977 |
| - <span class="region">CA</span> |
| 1975 | + <span class="locality"></span> |
| 1976 | + <span class="region"></span> |
1978 | 1977 | <span class="code"></span>
|
1979 | 1978 | </span>
|
1980 |
| - <span class="country-name vcardline">USA</span> |
| 1979 | + <span class="country-name vcardline"></span> |
1981 | 1980 | </span>
|
1982 |
| - <span class="vcardline">EMail: <a href="mailto:handrews@riverbed.com">handrews@riverbed.com</a></span> |
| 1981 | + <span class="vcardline">EMail: <a href="mailto:andrews_henry@yahoo.com">andrews_henry@yahoo.com</a></span> |
1983 | 1982 |
|
1984 | 1983 | </address>
|
1985 | 1984 | </div><div class="avoidbreak">
|
|
0 commit comments