| Table of Contents |
|---|
Document Status
This document is a Draft Deliverable of the Utility Foundry Working Group.
...
The aim of this specification is to define how DID URLs SHOULD act as persistent identifiers for referencing and retrieving digital resources (such as data schemas, interface definitions, governance documents, or policy definitions). Through using DID URLs which remain conformant with W3C Decentralized Identifiers (DIDs) 1.0 specification, existing DID Resolvers will be able to dereference these DID URLs to retrieve the identified resource using the specified Query Syntax for DID URLsDID URl query syntax in this specification.
Context
This specification builds on two existing concepts for processing a DID URL:
...
| Example | Explanation | Error |
|---|---|---|
| did:example:46e2af9a-2ea0-4815-999d-730a6778227c?resourceName=degreeLaw | There MAY be insufficient information for the VDR to process the request (for example, if there are multiple resource versions of the name degreeLaw, or different resource types of the name degreeLaw). | "notFound". |
| did:example:46e2af9a-2ea0-4815-999d-730a6778227c?resourceName=degreeLaw&resourceType=JSONSchema2020&versionTime=2018-07-19T08:40:00Z | The identified resource does not exist at the versionTime. | "notFound". |
| did:example:46e2af9a-2ea0-4815-999d-730a6778227c?resourceName=degreeLaw&resourceType=JSONSchema2020&versionId=2.1.4 | The identified version does not exist. | "notFound". |
Registration with the W3C DID Specification Registries
The Query Syntax for Resource DID URLs defined by this specification will be registered with the W3C DID Specification Registries 1.0 at the following URL:
https://www.w3.org/TR/did-spec-registries/#resource
Contributors
To comply with the intellectual property rights protections in the charter of the ToIP Foundation (as required by all Joint Development Foundation projects hosted the Linux Foundation), all contributors to this Pre-Draft Deliverable MUST be current members of the ToIP Foundation. The following contributors each certify that they meet this requirement:
Acknowledgements
The authors wish to thank the editors and contributors to the W3C Decentralized Identifiers (DIDs) 1.0 specification.
Licensing
This is a publicly available specification published by the ToIP Foundation under the following licenses:
- Copyright: Creative Commons Attribution 4.0.
- Patent: Joint Development Foundation W3C Mode (based on the W3C Patent Policy).