Documentation

APIs

APIXMLJSONTurtle
getNudsNUDS/XML
getRDFRDF/XML

Get NUDS

Get an aggregated NUDS/XML serialization based on the recordIds in the collection.
Webservice Type : REST
Url: https://oscar.nationalmuseum.ch/apis/getNuds?
Parameters : identifiers (recordIds divided by a pipe '|')
Result : returns NUDS/XML records aggregated in a nudsGroup root element.
Example: apis/getNuds?identifiers=oscar.8312|oscar.8170|oscar.803

Get RDF

Get an aggregated RDF/XML serialization based on the recordIds in the collection.
Webservice Type : REST
Url: https://oscar.nationalmuseum.ch/apis/getRDF?
Parameters : identifiers (recordIds divided by a pipe '|')
Result : returns RDF/XML triples for given objects/hoards/coin types.
Example: apis/getRDF?identifiers=oscar.8312|oscar.8170|oscar.803

OpenRefine Reconciliation Service

Coin type corpora published in Numishare enable reconciliation of reference identifiers to URIs for coin types and subtypes. Unlike the OpenRefine reconciliation API in Nomisma, Numishare-oriented APIs support additional query properties (e.g., for rulers, mints, and denominations) to further refine queries and enhance accuracy of matches.

All API responses are in JSON. Please see the API documentation and usage documentation for more details about general usage of reconciliation services in OpenRefine.

For specific insights and recommended workflows, please read Numishare supports OpenRefine reconciliation APIs for OCRE, PELLA, and CRRO.

Service URI:https://oscar.nationalmuseum.ch/apis/reconcile

Numishare supports the following reconciliation services for OpenRefine:

  • Main Reconciliation Service
  • Preview API
  • Property suggest
  • Entity Suggestion API (for autosuggest on matching terms)

Available Properties

Presently, the facet fields for a given type corpora are supported as properties, both for exact matching and free-text. It is recommended to reconcile additional property fields in your source spreadsheet (mints, rulers) to Nomisma first, and then use these reconciled preferred labels for exact matching property searches for coin type reconciliation.

  • State
  • Ruler
  • Issuer
  • Mint
  • Denomination
  • Material
  • Portrait
  • Reference

Data Access

Individual Records

Numishare supports delivery of individual records in a variety of models and serializations through both REST and content negotiation. Content negotiation (with the accept header) requests should be sent to the URI space https://oscar.nationalmuseum.ch/id/. Requesting an unsupported content type will result in an HTTP 406: Not Acceptable error.

ModelRESTContent Type
HTMLhttps://oscar.nationalmuseum.ch/id/{$id}text/html
NUDS/XMLhttps://oscar.nationalmuseum.ch/id/{$id}.xmlapplication/xml
KMLhttps://oscar.nationalmuseum.ch/id/{$id}.kmlapplication/vnd.google-earth.kml+xml
RDF/XMLhttps://oscar.nationalmuseum.ch/id/{$id}.rdfapplication/rdf+xml
Turtlehttps://oscar.nationalmuseum.ch/id/{$id}.ttltext/turtle
JSON-LDhttps://oscar.nationalmuseum.ch/id/{$id}.jsonldapplication/ld+json
geoJSONhttps://oscar.nationalmuseum.ch/id/{$id}.geojsonapplication/vnd.geo+json

Search Results

Search results (the browse page) are returned in HTML5, but Numishare supports Atom and RSS via REST, as well as Atom and raw Solr XML via content negotiation of the browse page URL, https://oscar.nationalmuseum.ch/results. The REST-based Atom feed sorts by the Lucene syntax 'timestamp desc' by default, but the sort parameter may be provided manually to alter the default field and order.

ModelRESTContent Type
HTMLhttps://oscar.nationalmuseum.ch/resultstext/html
Atomhttps://oscar.nationalmuseum.ch/feed/application/atom+xml
RSShttps://oscar.nationalmuseum.ch/apis/search?q=*:*&format=rssN/A
Solr/XMLN/Aapplication/xml

Geographic Responses

Search results may also be serialized into geographic models when relevant, for example to show the mints, findspots, or subjects related to the current query. Results are made available in KML and geoJSON.

Response TypegeoJSONKML
Mintshttps://oscar.nationalmuseum.ch/mints.geojsonhttps://oscar.nationalmuseum.ch/mints.kml
Findspotshttps://oscar.nationalmuseum.ch/findspots.geojsonhttps://oscar.nationalmuseum.ch/findspots.kml
Subjectshttps://oscar.nationalmuseum.ch/subjects.geojsonhttps://oscar.nationalmuseum.ch/subjects.kml

Nomisma RDF Dump

Data dumps conforming to the Nomisma ontology are linked on the index page. At present, these files are only available in RDF/XML.

Pelagios RDF Dump

Data dumps conforming to the Pelagios 3 model are linked on the index page. At present, these files are only available in RDF/XML.