JACQ Objects Webservice

GET specimens/{specimenID}

summary	get the properties of a specimen
API-description	OpenAPI JSON
Response	{ "dc": { "dc:…": Dublin Core Items } "dwc": { "dwc:…": Darwin Core Items } "jacq": { "jacq:…": JACQ Items } }
Example	https://services.jacq.org/jacq-services/rest/objetcs/specimens/1739342 get all properties of specimen-ID 1739342

POST specimens/fromList

summary	post a list of specimen-IDs, Unit-IDs or Stable Identifiers to get a list of the properties of each specimen in case of Unit-IDs or Stable Identifiers, trailing characters are silently ignored
API-description	OpenAPI JSON
Response	[ { "dc": { "dc:…": Dublin Core Items } "dwc": { "dwc:…": Darwin Core Items } "jacq": { "jacq:…": JACQ Items } },… ]
Example	https://services.jacq.org/jacq-services/rest/objetcs/specimens/fromList get all properties of the following list of specimen-IDs, Unit-IDs and Stable identifiers
	[ "W20050021049_a.jpg", "http://w.jacq.org/W20050021048", "WU0020000", 1739342, 435533, 10000 ]

POST specimens/fromFile

summary

post a file with a list of specimen-IDs, Unit-IDs or Stable Identifiers to get a list of the properties of each specimen
in case of Unit-IDs or Stable Identifiers, trailing characters are silently ignored
operates like "fromList"

Response

[

  "dc":   {

           "dc:…":   Dublin Core Items

  "dwc":  {

           "dwc:…":  Darwin Core Items

  "jacq": {

           "jacq:…": JACQ Items

 },…

]

GET specimens

summary

search for all specimens which fit given criteria, return just a list of specimen-IDs or the whole specimen data

search and sort
Parameters

list	return just a list (=1) or the whole specimen data (=0). Default: 1
term	search for taxon term. Use * as a wildcard. Multiple terms seperated by ','.
herbnr	search for herbarium number. Use * as a wildcard.
collnr	search for collection number. Use * as a wildcard.
sc	search for source code. Case-insensitive.
cltr	search for collector(s). Case-insensitive.
nation	search for nation. Case-insensitive.
type	switch to search for type records only. Default: 0 (all records)
withImages	switch to search for records with images only. Default: 0 (all records)
sort	sort order of the result. "-" as first character changes sorting to DESC. default: sciname,herbnr Possible values are: sciname - scientific name herbnr - herbarium number cltr - collectors ser - series num - collectors number

API-description

OpenAPI JSON

Response

  "total":        total number of records found

  "itemsPerPage": records per page

  "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

  "result":       List of found entries

        "dc":   {

                 "dc:…":   Dublin Core Items

        "dwc":  {

                 "dwc:…":  Darwin Core Items

        "jacq": {

                 "jacq:…": JACQ Items

       },…

Example

https://services.jacq.org/jacq-services/rest/objetcs/specimens?list=0&term=prunus av*&sc=wu
search for all specimens with taxon "prunus av*" of source wu, display the first page with 50 records per page

Response of all Requests

All requests may respond with the same three blocks: dc (DublinCore), dwc (DarwinCore), jacq (internal data)
In case of an empty descriptor (no data available), the descriptor is omitted.
These descriptors are used:

"dc"	title description creator created type
"dwc"	materialSampleID basisOfRecord collectionCode catalogNumber scientificName previousIdentifications family genus specificEpithet country countryCode locality decimalLatitude decimalLongitude verbatimLatitude verbatimLongitude eventDate recordNumber recordedBy fieldNumber
"jacq"	specimenID scientificName family genus epithet HerbNummer observation taxon_alt Fundort decimalLatitude decimalLongitude verbatimLatitude verbatimLongitude collectorTeam created Nummer series alt_number WIKIDATA_ID HUH_ID VIAF_ID ORCID OwnerOrganizationAbbrev OwnerLogoURI LicenseURI nation_engl iso_alpha_3_code image downloadImage