BARTOC API

Available Endpoints

This service provides a subset of JSKOS API 2.2. All the following endpoints are available on this instance of jskos-server. See documentation on GitHub for details.

General

• GET /status - Return a status object (JSON Schema) 🛈
• GET /checkAuth - Check whether a user is authorized 🛈
• POST/GET /validate - Validate JSKOS data 🛈
• GET /data - Return data for a certain URI or URIs (terminologies, concepts, concordances, mappings, annotations, registries) 🛈

Terminologies

• GET /voc - Return a list of vocabularies (terminologies) 🛈
• GET /voc/top - Return top concepts for a terminology 🛈
• GET /voc/concepts - Return concepts for a terminology 🛈
• GET /voc/suggest - Return terminology suggestions in OpenSearch Suggest Format 🛈
• GET /voc/search - Concept scheme search 🛈
• WS /voc/changes - Real-time updates for terminologies via WebSocket 🛈
• POST /voc - Save a terminology or multiple terminologies in the database 🔒 🛈
• PUT /voc - Update a terminology in the database 🔒 🛈

Concepts

• GET /concepts - Return detailed data for concepts or terminologies 🛈
• GET /concepts/narrower - Return narrower concepts for a concept 🛈
• GET /concepts/ancestors - Return ancestor concepts for a concept 🛈
• GET /concepts/suggest - Return concept suggestions 🛈
• GET /concepts/search - Concept search 🛈
• WS /concepts/changes - Real-time updates for concepts via WebSocket 🛈

Mappings

• GET /mappings - Return a list of mappings 🛈
• GET /mappings/:_id - Return a specific mapping 🛈
• GET /mappings/infer - Return mappings based on stored mappings and mappings derived by inference 🛈
• GET /mappings/apply - Apply mappings to a set of uris 🛈
• POST /mappings/apply - Apply mappings to a set of items 🛈
• GET /mappings/suggest - Suggest notations used in mappings 🛈
• GET /mappings/voc - Return a list of terminologies used in mappings 🛈
• WS /mappings/changes - Real-time updates for mappings via WebSocket 🛈

Registries

• GET /registries - Return a list of registries 🛈
• GET /registries/suggest - Return registry suggestions 🛈
• POST /registries - Save registries in the database 🛈
• PUT /registries - Update a registry in the database 🛈
• PATCH /registries/:_id - Adjust a registry in the database 🛈
• DELETE /registries - Delete registries from the database 🛈
• WS /registries/changes - Real-time updates for registries via WebSocket 🛈