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
Rename the discovery endpoints field to descriptor and move the schema id to vdprotocol.org
The endpoints map in /.well-known/vdp pointed at view descriptor
resources through a field named "template"; it is now "descriptor",
with the DiscoveryDocument schema definition updated to match. Schema
$id and $ref examples now use vdprotocol.org instead of vdp.dev.
"description": "Schema for VDP view descriptor documents. Validates standalone ViewDescriptor and MultiViewDescriptor payloads. Definitions in $defs can be referenced by other schemas for inline body transport (_view / _views).",
15
15
@@ -89,9 +89,18 @@ The VDP JSON Schema defines the structure of view descriptor documents. It uses
89
89
},
90
90
"endpoints": {
91
91
"type": "object",
92
-
"description": "A map of API endpoint paths to their default view descriptors.",
92
+
"description": "A map of API endpoint paths to the URL of each endpoint's view descriptor resource.",
93
93
"additionalProperties": {
94
-
"$ref": "#/$defs/ViewDescriptor"
94
+
"type": "object",
95
+
"properties": {
96
+
"descriptor": {
97
+
"type": "string",
98
+
"format": "uri",
99
+
"description": "URL of the view descriptor resource for this endpoint."
100
+
}
101
+
},
102
+
"required": ["descriptor"],
103
+
"additionalProperties": false
95
104
}
96
105
},
97
106
"trustedTemplateDomains": {
@@ -152,7 +161,7 @@ Served at `/.well-known/vdp` for API discovery.
152
161
| Property | Type | Required | Description |
153
162
|----------|------|----------|-------------|
154
163
|`version`|`string`| Yes | VDP specification version |
155
-
|`endpoints`|`object`| No | Map of API paths to their default view descriptors|
164
+
|`endpoints`|`object`| No | Map of API paths to `{ "descriptor": <url> }` entries pointing at each endpoint's view descriptor resource|
156
165
|`trustedTemplateDomains`|`string[]`| No | Allowlist of base URLs for template loading |
157
166
158
167
## Validation
@@ -162,7 +171,7 @@ The schema validates standalone VDP documents (view descriptor JSON files). For
This allows clients to prefetch view descriptors and preload templates before making data requests. The `trustedTemplateDomains` field provides the template URL allowlist referenced in Section 10.
642
+
Each entry in `endpoints` maps an API path to the URL of its view descriptor resource (`descriptor`). This allows clients to prefetch view descriptors and preload templates before making data requests. The `trustedTemplateDomains` field provides the template URL allowlist referenced in Section 10.
0 commit comments