You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: index.bs
+21-22
Original file line number
Diff line number
Diff line change
@@ -271,7 +271,7 @@ The `resourceName` property is OPTIONAL. If present, the value of the type prope
271
271
Resource Type {#resourcetype}
272
272
---------------------
273
273
274
-
The `resourceType` property is OPTIONAL. If present, the value of the type property MUST be expressed as an [ASCII string](https://infra.spec.whatwg.org/#ascii-string). In order to maximize interoperability, the resource type and its associated properties SHOULD be registered in the DID Specification Registries [DID-SPEC-REGISTRIES].
274
+
The `resourceType` property is OPTIONAL. If present, the value of the type property MUST be expressed as an [ASCII string](https://infra.spec.whatwg.org/#ascii-string). In order to maximize interoperability, the resource type and its associated properties SHOULD be registered in the DID Specification Registries [[DID-SPEC-REGISTRIES]].
275
275
276
276
Resource Version {#resourceversion}
277
277
---------------------
@@ -286,27 +286,27 @@ The `alternativeUri` property is OPTIONAL. If present, the value MUST be a set w
The `mediaType` property is OPTIONAL. If present, the value must be expressed as an [ASCII string](https://infra.spec.whatwg.org/#ascii-string) and SHOULD match the underlying IANA media type of the file of the resource identified by the resourceId.
292
292
293
-
### Checksum
293
+
### Checksum {#checksum}
294
294
295
295
The `checksum` property is OPTIONAL. If present, the value SHOULD be an equivalent representation of the resource identified by the resourceId.
296
296
297
-
### Created
297
+
### Created {#created}
298
298
299
299
The `created` property is OPTIONAL. If present, the value of the property MUST be a string formatted as an XML Datetime normalized to UTC 00:00:00 and without sub-second decimal precision. For example: 2020-12-20T19:17:47Z.
300
300
301
-
### Updated
301
+
### Updated {#updated}
302
302
303
303
The `updated` property is OPTIONAL. If present, the value of the property MUST be a string formatted as an XML Datetime normalized to UTC 00:00:00 and without sub-second decimal precision. For example: 2020-12-20T19:17:47Z.
304
304
305
-
### PreviousVersionId
305
+
### PreviousVersionId {#previousversionid}
306
306
307
307
The `previousVersionId` property is OPTIONAL. If present, the value should reference the directly previous version of the resource. The value of the property MUST be an ASCII string.
308
308
309
-
### NextVersionId
309
+
### NextVersionId {#nextversionid}
310
310
311
311
The `nextVersionId` property is OPTIONAL. If present, the value should reference the directly next version of the resource. The value of the property MUST be an ASCII string.
312
312
@@ -412,7 +412,7 @@ When queried in aggregate, the result MUST return an array of Resource Metadata
412
412
Resource Parameters {#resourceparameters}
413
413
=====================
414
414
415
-
The Resource URI syntax supports a simple format for parameters (see section Query in [DID-CORE]). Adding a resource parameter to a Resource URI means that the parameter becomes part of the identifier for a resource.
415
+
The Resource URI syntax supports a simple format for parameters (see section Query in [[DID-CORE]]). Adding a resource parameter to a Resource URI means that the parameter becomes part of the identifier for a resource.
416
416
417
417
Resource parameters are completely independent of any specific DID method and function the same way for all DIDs.
418
418
@@ -512,21 +512,21 @@ Rules and Logic for Handling Ambiguous Queries {#ambiguity}
512
512
513
513
This section describes how the resolver handles complex or ambiguous dereferencing requests. The resolver applies consistent logic and default behaviors to ensure predictable outcomes for clients.
514
514
515
-
Ambiguity Triggers Errors
515
+
Ambiguity Triggers Errors {#ambiguityerror}
516
516
--------------------------
517
517
518
518
If a query results in multiple matching resources and does not include sufficient parameters to disambiguate between them, the resolver MUST return an error.
519
519
520
520
For example, a query that specifies a `resourceType` where multiple resources share that type but differ in `resourceName` will result in an error due to ambiguity.
521
521
522
-
Multiple Versions of the Same Resource
522
+
Multiple Versions of the Same Resource {#multipleversions}
523
523
--------------------------------------
524
524
525
525
If multiple versions of a single resource exist—meaning the resources have the same `resourceType` and `resourceName`, but different `versionId` values—and no specific version is requested, the resolver MUST default to returning the latest version.
526
526
527
527
This situation is not considered ambiguous, as the resource identity is clear; only the version is unspecified.
528
528
529
-
Ambiguous Query with `resourceMetadata=true`
529
+
Ambiguous Query with `resourceMetadata=true` {#ambiguityplusmetadata}
530
530
--------------------------------------------
531
531
532
532
When a query is ambiguous, but includes the `resourceMetadata=true` parameter, the resolver SHOULD return metadata for all matching resources that could be the intended target.
@@ -606,10 +606,10 @@ Clients MAY use the `Accept` HTTP header to express a preference for the media t
606
606
607
607
The resolver MUST respect the `Accept` header if possible and return a resource representation that matches the requested media type. If no exact match is found, the resolver SHOULD return an error status, following the statuses in the DID Resolution Spec, or fall back to a default media type if appropriate.
608
608
609
-
Resolution and Dereferecing examples {#examples}
609
+
Resolution and Dereferecing examples {#resolutionanddereferencingexamples}
610
610
=====================
611
611
612
-
ResourceMetadata and Filter
612
+
ResourceMetadata and Filter {#resourcemetadatafilter}
613
613
---------------------
614
614
615
615
This parameter is a filter that spefically returns metadata of one or more resources and can be combined with other filters, for specific filtering. The optional variants are:
`resourceCollectionId` parameter filters all resources linked to a particular DID by the `collectionId` property. It is recommended that this query is only used when there is one resource linked to a DID. If it is used with multiple resources, it is recommended to be combined with another query parameter to act as a filter such as `resourceMetadata=true`. Otherwise, it is likely to result in an ambigous query.
@@ -790,7 +790,7 @@ The resource itself is returned. In this example, we show a returned schema:
790
790
</details>
791
791
792
792
793
-
ResourceType Parameter
793
+
ResourceType Parameter {#resourcetypeparameter}
794
794
---------------------
795
795
796
796
This parameter is another filter for the `resourceType` property. Again, this should only be used if there is one resource associated with the DID. Otherwise additional filters should be added to avoid ambiguous queries.
@@ -836,8 +836,7 @@ The resource itself is returned. In this example, we show a returned schema:
836
836
</details>
837
837
838
838
839
-
840
-
ResourceName Parameter
839
+
ResourceName Parameter {#resourcenameparameter}
841
840
---------------------
842
841
843
842
This parameter is a filter for the `resourceName` property. Again, this should only be used if there is one resource associated with the DID. Otherwise additional filters should be added to avoid ambiguous queries.
@@ -882,7 +881,7 @@ The resource itself is returned. In this example, we show a returned schema:
0 commit comments