API Documentation

Preset Queries for convenience

Blueprint "whatisthis"

This is a convenience endpoint, that allows for loosely filtered searches on identifiers or wildcard searches based on the last part of an identifier (useful for finding UUID crosswalks).

GET /whatisthis/

Response will be an HTML form to allow for easy entry of the identifier search term.

Multiple methods for passing the search term are accepted:

GET /whatisthis/{id search term}

GET /whatisthis?ident={id search term}

POST /whatisthis/ (form data: ident={id search term})

Responds with an AnnotationCollection response based on a search using the supplied id search term. The search can be understood as follows:

copyLink Body ID LIKE "%{id}" or Link Target ID LIKE "%{id}"

For example, a search on 'yy5' might turn up the following response:

copy{
  "@context": "http://www.w3.org/ns/anno.jsonld",
  "first": {
    "id": "http://localhost:5001/id-management/whatisthis/yy5/page/1",
    "items": [
      {
        "body": {
          "generator": "https://data.getty.edu/local/thesaurus/generators/lodlvl2",
          "id": "component/83c323a2-2de9-5bfe-850a-e6b9de054bb4"
        },
        "created": "Wed, 17 Jun 2020 07:46:47 GMT",
        "id": "urn:uuid:42792605-03ad-4ea1-b131-c1f135aaad46",
        "modified": "Wed, 17 Jun 2020 07:46:47 GMT",
        "motivation": "https://data.getty.edu/local/thesaurus/motivations/contains-refid",
        "target": {
          "generator": "https://data.getty.edu/local/thesaurus/organizations/GRI",
          "id": "urn:getty-local:ref954_yy5"
        },
        "type": "Annotation"
      },
      {
        "body": {
          "generator": "https://data.getty.edu/local/thesaurus/generators/lodlvl2",
          "id": "component/394f95d1-a87a-550e-b61b-9ebe73a477fb"
        },
        "created": "Wed, 17 Jun 2020 07:35:46 GMT",
        "id": "urn:uuid:b8eadef0-196a-4d67-97ad-1d38eef1a5d3",
        "modified": "Wed, 17 Jun 2020 07:35:46 GMT",
        "motivation": "https://data.getty.edu/local/thesaurus/motivations/contains-refid",
        "target": {
          "generator": "https://data.getty.edu/local/thesaurus/organizations/GRI",
          "id": "urn:getty-local:ref4244_yy5"
        },
        "type": "Annotation"
      },
      // ... RESPONSE ITEMS TRUNCATED ...
    ],
    "startIndex": 0,
    "type": "AnnotationPage"
  },
  "id": "http://localhost:5001/id-management/whatisthis/yy5/page/1",
  "label": "Search: body or target identifier that ends with yy5",
  "total": 11,
  "type": "AnnotationCollection"
}