MappingAssertion — JSON-LD

GET

/id/mapping/{uuid}.json

const url = 'https://textrefs.org/id/mapping/example.json';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://textrefs.org/id/mapping/example.json

Parameters

Path Parameters

uuid

required

string

/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/

Responses

200

MappingAssertion record as JSON-LD.

application/json

object

status

required

string

Allowed values: draft active deprecated withdrawn blocked

created

required

string

/^\d{4}-\d{2}-\d{2}$/

modified

required

string

/^\d{4}-\d{2}-\d{2}$/

superseded_by

Successor IRI. Only present when status is deprecated, withdrawn, or blocked.

string format: iri

required

string

/^https://textrefs\.org/id/mapping/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/

type

required

string

Allowed values: MappingAssertion

subject

required

MUST be a Work IRI.

string

/^https://textrefs\.org/id/work/[a-z0-9][a-z0-9._-]*$/

relation

required

Chosen by what the target is (ADR-0006). alternateOf (prov:alternateOf) — another entity denoting the same work. isReferencedBy (dcterms:isReferencedBy) — a document or page about the work.

string

Allowed values: alternateOf isReferencedBy

target

required

object

identifier

required

An IRI (RFC 3987), not a URI (RFC 3986). The registry publishes resolver targets that carry non-ASCII characters, such as …/Investigaciones_filosóficas_(edición_A). RFC 3986 forbids those characters, so a validator that enforces the uri format rejects records this site serves. The generated JSON Schema declares iri for the same reason.

string format: iri

conforms_to

One of:

string
Array<string>

string format: iri

source

required

string

>= 1 characters

Example

{
  "status": "draft",
  "type": "MappingAssertion",
  "relation": "alternateOf"
}

404

No registry object found at this identifier. The site is static, so the host cannot build a per-path error body. It serves the site’s own 404 page instead: text/html, with the same navigation as every other page. A client detects the miss from the status code, not from the body.

text/html

The site’s HTML 404 page.

string