TextRefs
Overview
HTTP contract for the canonical `/id/` namespace on textrefs.org.
TextRefs Registry & Resolver 0.1.0
Section titled “TextRefs Registry & Resolver 0.1.0”Every TextRefs record is served at two static URLs:
/id/{type}/{key}/— HTML for browsers./id/{type}/{key}.json— JSON-LD for machines.
There is no Accept-header content negotiation. Clients either
follow the <link rel="alternate" type="application/json" href="…json">
advertised in the HTML head, or simply append .json to the canonical
URL. JSON bodies carry the JSON-LD @context at
/contexts/v1.jsonld; the
Zod schemas in
standard/schema/
remain the source of truth.
The Accept-Language / edition-based 303 redirect on
/id/ref/{uuid} to a resolver-target manifestation is planned but not
yet live.