Skip to content

Propose verifiable-credential+ld+json media type #1034

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 6 commits into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 50 additions & 1 deletion index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5104,7 +5104,7 @@ <h2>IANA Considerations</h2>
</li>
</ul>

<section id="media-type">
<section id="credential-media-type">
<h2>The <code>application/credential+ld+json</code> Media Type</h2>
<p>
This specification registers the <code>application/credential+ld+json</code> MIME Media Type specifically for
Expand Down Expand Up @@ -5154,7 +5154,56 @@ <h2>The <code>application/credential+ld+json</code> Media Type</h2>
</p>

</section>
<section id="verifiable-credential-media-type">
<h2>The <code>application/vc+ld+json</code> Media Type</h2>
<p>
This specification registers the <code>application/vc+ld+json</code> Media Type specifically for
identifying documents
conforming to the Verifiable Credentials format.
</p>
<table>
<tr>
<td>Type name: </td>
<td>application</td>
</tr>
<tr>
<td>Subtype name: </td>
<td>vc+ld+json</td>
</tr>
<tr>
<td>Required parameters: </td>
<td>None</td>
</tr>
<tr>
<td>Encoding considerations: </td>
<td>
Resources that use the "<code>application/verifiable-credential+ld+json</code>"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Resources that use the "<code>application/verifiable-credential+ld+json</code>"
Resources that use the "<code>application/vc+ld+json</code>"

Media Type are required to conform to all of the requirements
for the "<code>application/credential+ld+json</code>" Media Type and are
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Points back at application/credential+ld+json... related to the debate that is not resolved on #1014

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This makes me think (again) that
IF we're going to have media types for both verifiable and unverifiable credentials
application/verifiable-credential+ld+json
(hyphen, i.e., parallel type to application/credential+ld+json)
should instead be
application/verifiable+credential+ld+json
(plus, i.e., subtype of application/credential+ld+json)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
for the "<code>application/credential+ld+json</code>" Media Type and are
for the "<code>application/ld+json</code>" Media Type and are

therefore subject to the same encoding considerations specified
in Section 11 of [[!RFC7159]].
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
in Section 11 of [[!RFC7159]].
in Section 11 of [[!RFC7159]] and [[JSON-LD]].

</td>
</tr>
<tr>
<td>Security considerations: </td>
<td>As defined in the Verifiable Credentials Data Model <a href="https://w3c.github.io/vc-data-model/#security-considerations">Security Considerations</a> section.</td>
</tr>
<tr>
<td>Contact: </td>
<td>
W3C Verifiable Credentials Working Group <a href="mailto:[email protected]">[email protected]</a>
</td>
</tr>
</table>

<p>
Note that while the Verifiable Credentials format uses JSON-LD
conventions, there are a number of constraints and additional
requirements for Verifiable Credential implementations that justify
the use of a specific media type.
</p>

</section>

</section>

Expand Down