Skip to content

Commit 8e04d15

Browse files
committed
Update to remove normative discussion of the Link header in requests per resolution.
1 parent 6b4b4fe commit 8e04d15

File tree

1 file changed

+2
-77
lines changed

1 file changed

+2
-77
lines changed

index.html

Lines changed: 2 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -10480,16 +10480,13 @@ <h3>application/ld+json</h3>
1048010480
<dt><code>http://www.w3.org/ns/json-ld#framed</code></dt>
1048110481
<dd>To request or specify <a href="#framed-document-form">framed JSON-LD document form</a>.</dd>
1048210482
</dl>
10483+
<p class="note">Other specifications may publish additional profile parameter
10484+
URIs with their own defined sematics.</p>
1048310485
<p>
1048410486
When used as a <a data-cite="RFC4288#section-4.3">media type paramter</a> [[RFC4288]]
1048510487
in an <a data-cite="rfc7231#section-5.3.2">HTTP Accept header</a> [[RFC7231]],
1048610488
the value of the <code>profile</code> parameter MUST be enclosed in quotes (<code>"</code>) if it contains
1048710489
special characters such as whitespace, which is required when multiple profile URIs are combined.</p>
10488-
<p>Relevant contextual information, such as URLs to provide contexts or frames
10489-
associated with the <code>http://www.w3.org/ns/json-ld#compacted</code>
10490-
and <code>http://www.w3.org/ns/json-ld#framed</code> profiles
10491-
are described in the published specification.</p>
10492-
<p>JSON-LD processors MAY place restrictions on supported profiles.</p>
1049310490
<p>When processing the "profile" media type parameter, it is important to
1049410491
note that its value contains one or more URIs and not IRIs. In some cases
1049510492
it might therefore be necessary to convert between IRIs and URIs as specified in
@@ -10564,48 +10561,6 @@ <h3>application/ld+json</h3>
1056410561
<a data-cite="RDF11-CONCEPTS#section-fragID">RDF 1.1 Concepts and Abstract Syntax</a>
1056510562
[[RDF11-CONCEPTS]].</p>
1056610563

10567-
<section id="request-link-header">
10568-
<h3>Link header in HTTP request</h3>
10569-
<p>When using the <code>http://www.w3.org/ns/json-ld#compacted</code> profile
10570-
in an HTTP request Accept header on the application/ld+json media type,
10571-
the context to use for compacting MAY be specified
10572-
using the <a data-cite="RFC8288#section-3">HTTP Link Header</a> as defined in [[RFC8288]].</p>
10573-
10574-
<p>When satisfying an HTTP request where the profile parameter includes
10575-
<code>http://www.w3.org/ns/json-ld#compacted</code>, processors MUST retrive
10576-
any <a>JSON-LD document</a> referenced by a <a data-cite="RFC8288#section-3">Link Header</a> with:</p>
10577-
10578-
<ul>
10579-
<li><code>rel="http://www.w3.org/ns/json-ld#context"</code>, and</li>
10580-
<li><code>type="application/ld+json"</code>.</li>
10581-
</ul>
10582-
10583-
<p>The referenced document MUST have a top-level <a>JSON object</a>
10584-
with a <code>@context</code> <a>member</a>.</p>
10585-
10586-
<p>When using the <code>http://www.w3.org/ns/json-ld#framed</code> profile
10587-
in an HTTP request Accept header on the application/ld+json media type,
10588-
the context to use for compacting MAY be specified
10589-
using the <a data-cite="RFC8288#section-3">HTTP Link Header</a> as defined in [[RFC8288]].</p>
10590-
10591-
<p>When satisfying an HTTP request where the profile parameter includes
10592-
<code>http://www.w3.org/ns/json-ld#framed</code>, processors MUST retrive
10593-
any <a>JSON-LD document</a> referenced by a <a data-cite="RFC8288#section-3">Link Header</a> with:</p>
10594-
10595-
<ul>
10596-
<li><code>rel="http://www.w3.org/ns/json-ld#frame"</code>, and</li>
10597-
<li><code>type="application/ld+json"</code>.</li>
10598-
</ul>
10599-
10600-
<p>The referenced document MUST be a valid JSON-LD frame document as described in [[JSON-LD11-FRAMING]].</p>
10601-
10602-
<p>A request MUST NOT
10603-
contain more than one <a data-cite="RFC8288#section-3">HTTP Link Header</a> [[RFC8288]] using the
10604-
<code>http://www.w3.org/ns/json-ld#context</code>
10605-
or <code>http://www.w3.org/ns/json-ld#frame</code>link relations.</p>
10606-
10607-
<p class="issue">Can JSON-LD processors place restrictions on client-provided context or frame URLs?</p>
10608-
</section>
1060910564
<section id="iana-examples" class="informative">
1061010565
<h3>Examples</h3>
1061110566
<p>The following examples illustrate different ways in which the profile parameter may be used
@@ -10654,36 +10609,6 @@ <h3>Examples</h3>
1065410609
and <a href="#flattened-document-form">flattened document form</a>.
1065510610
Note that as whitespace is used to separate the two URIs, they
1065610611
are enclosed in double quotes (<code>"</code>).</p>
10657-
10658-
<pre class="example" data-transform="updateExample"
10659-
data-content-type="http"
10660-
data-ignore
10661-
title="HTTP Request with profile requesting a compacted document">
10662-
<!--
10663-
GET /ordinary-json-document.json HTTP/1.1
10664-
Host: example.com
10665-
Accept: application/ld+json;****profile=http://www.w3.org/ns/json-ld#compacted****
10666-
-->
10667-
</pre>
10668-
<p>Requests the server to return the requested resource as JSON-LD
10669-
in <a href="#compacted-document-form">compacted document form</a>.
10670-
As no explicit context resource is specified, the server compacts
10671-
using an application-specific default context.</p>
10672-
10673-
<pre class="example" data-transform="updateExample"
10674-
data-content-type="http"
10675-
data-ignore
10676-
title="HTTP Request with profile requesting a framed document with a reference to the framing document">
10677-
<!--
10678-
GET /ordinary-json-document.json HTTP/1.1
10679-
Host: example.com
10680-
Accept: application/ld+json;****profile=http://www.w3.org/ns/json-ld#framed****
10681-
****Link: <https://json-ld.org/frames/library.jsonld>; rel="http://www.w3.org/ns/json-ld#frame"; type="application/ld+json"****
10682-
-->
10683-
</pre>
10684-
<p>Requests the server to return the requested resource as JSON-LD
10685-
in <a href="#framed-document-form">framed document form</a>
10686-
and specifies the location of a frame to use.</p>
1068710612
</section>
1068810613
</section>
1068910614

0 commit comments

Comments
 (0)