JSKOS Server

Available Endpoints

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

General

• GET /status - Returns a status object (JSON Schema, documentation)
• GET /checkAuth - Endpoint to check whether a user is authorized (documentation)
• POST/GET /validate - Endpoint to validate JSKOS data (documentation)
• GET /data - Returns data for a certain URI or URIs (concept schemes, concepts, concordances, mappings, annotations) (documentation)

Concordances

• GET /concordances - Returns a list of concordances for mappings (documentation)
• GET /concordances/:_id - Returns a specific concordance (documentation)
• POST /concordances - Saves a concordance in the database (authentication needed, documentation)
• PUT /concordances/:_id - Overwrites a concordance in the database (authentication needed, documentation)
• PATCH /concordances/:_id - Adjusts a mapping in the database (authentication needed, documentation)
• DELETE /concordances/:_id - Deletes a mapping from the database (authentication needed, documentation)

Mappings

• GET /mappings - Returns a list of mappings (documentation)
• GET /mappings/:_id - Returns a specific mapping (documentation)
• POST /mappings - Saves a mapping in the database (authentication needed, documentation)
• PUT /mappings/:_id - Overwrites a mapping in the database (authentication needed, documentation)
• PATCH /mappings/:_id - Adjusts a mapping in the database (authentication needed, documentation)
• DELETE /mappings/:_id - Deletes a mapping from the database (authentication needed, documentation)
• GET /mappings/infer - Returns mappings based on stored mappings and mappings derived by inference (documentation)
• GET /mappings/suggest - Suggests notations used in mappings (documentation)
• GET /mappings/voc - Returns a list of concept schemes used in mappings (documentation)

Concept Schemes

• GET /voc - Returns a list of vocabularies (concept schemes) (documentation)
• GET /voc/top - Lists top concepts for a concept scheme (documentation)
• GET /voc/concepts - Lists concepts for a concept scheme (documentation)
• GET /voc/suggest - Returns concept scheme suggestions in OpenSearch Suggest Format (documentation)
• GET /voc/search - Concept scheme search (documentation)

Concepts

• GET /concepts - Returns detailed data for concepts or concept schemes (documentation)
• GET /concepts/narrower - Returns narrower concepts for a concept (documentation)
• GET /concepts/ancestors - Returns ancestor concepts for a concept (documentation)
• GET /concepts/suggest - Returns concept suggestions (documentation)
• GET /concepts/search - Concept search (documentation)

Annotations

• GET /annotations - Returns a list of annotations (documentation)
• GET /annotations/:_id - Returns a specific annotation (documentation)
• POST /annotations - Saves an annotation in the database (authentication needed, documentation)
• PUT /annotations/:_id - Overwrites an annotation in the database (authentication needed, documentation)
• PATCH /annotations/:_id - Adjusts an annotation in the database (authentication needed, documentation)
• DELETE /annotations/:_id - Deletes an annotation from the database (authentication needed, documentation)