JACQ Webservices

scinames autocomplete classification stable Identifier iiif objects

JACQ stable Identifier Webservice

GET sid/{specimenID}

summary Get specimen-id, valid stable identifier and all stable identifiers of a given specimen-id
API-description OpenAPI JSON
Response {
 "specimenID":             ID of specimen

 "stableIdentifierLatest": latest stable identifier

     {

      "stableIdentifier":  stable identifier

      "timestamp":         and its timestamp

     }

 "stableIdentifierList":   list of all found stable identifiers, ordered by timestamp

     [

      {

       "stableIdentifier": stable identifier

       "timestamp":        and its timestamp

      },…

     ]

}
Example https://services.jacq.org/jacq-services/rest/stableIdentifier/sid/6830
look for specimen ID and stable identifiers of specimen-ID 6830

GET resolve/{sid}

summary Get specimen-id, valid stable identifier and all stable identifiers of a given stable idnetifier.
Answers with 303 instead of 200 if parameter "withredirect" is given
Response {
 "specimenID":             ID of specimen

 "stableIdentifierLatest": latest stable identifier

     {

      "stableIdentifier":  stable identifier

      "timestamp":         and its timestamp

      "link":              link to details-page of JACQ (for convenience)

     }

 "stableIdentifierList":   list of all found stable identifiers, ordered by timestamp

     [

      {

       "stableIdentifier": stable identifier

       "timestamp":        and its timestamp

      },…

     ]

}
Example https://services.jacq.org/jacq-services/rest/stableIdentifier/resolve/https://wu.jacq.org/WU-0000264
look for specimen ID and stable identifiers of stable identifier https://wu.jacq.org/WU-0000264
https://services.jacq.org/jacq-services/rest/stableIdentifier/resolve/https://wu.jacq.org/WU-0000264?withredirect=1
same as above, but with redirect (303)

GET errors

summary get a list of all errors which prevent the generation of stable identifiers
Response
 {

  "total":        total number of records found

  "result":       List of found entries

      [

       {

        "specimenID":             ID of specimen

        "link":                   link to details-page of JACQ (for convenience)

        "errorList":              List of errors and existing stable identifiers (if any) for this specimen-ID

            [

             {

              "stableIdentifier": stable identifier (if it exists) or null

              "timestamp":        timestamp of creation

              "error":            and the error

              "link":             link to details-page of JACQ of the blocking specimen (if present) (for convenience)

             },…

            ]

       },…

      ]

 },…

Example https://services.jacq.org/jacq-services/rest/stableIdentifier/errors
get a list of all errors which prevented the generation of stable identifiers
Example https://services.jacq.org/jacq-services/rest/stableIdentifier/errors?sourceID=1
get a list of all errors from source-ID 1 (WU) which prevented the generation of stable identifiers for this source

GET multi

summary Get all entries with more than one stable identifier per specimen-ID
Response
 {

  "page":         page displayed

  "previousPage": link to previous page

  "nextPage":     link to next page

  "firstPage":    link to first page

  "lastPage":     link to last page

  "totalPages":   total number of pages

  "total":        total number of records found

  "result":       List of found entries

      [

       {

        "specimenID":             ID of specimen

        "numberOfEntries":        # of records found for this ID

        "stableIdentifierList":   List of stable identifiers for this ID

            [

             {

              "stableIdentifier": stable identifier

              "timestamp":        and its timestamp

             },…

            ]

       },…

      ]

 },…

Example https://services.jacq.org/jacq-services/rest/stableIdentifier/multi
get the first 50 entries of specimen-IDs with more than one stable identifier
Example https://services.jacq.org/jacq-services/rest/stableIdentifier/multi?page2&entriesPerPage=100
get the third 100 entries of specimen-IDs with more than one stable identifier
Example https://services.jacq.org/jacq-services/rest/stableIdentifier/multi?sourceID=1
get all entries of source WU (ID 1) with more than one stable identifier