We designed the Domoscio API in a Restful way, so that your user experience is simple and straightforward.
You will find in this documentation all the information necessary to interact with the API.
To keep in touch with the latest developments, check the Changelog just here!
The workflow to authentify is based on Oauth2 protocol. The AuthorizationToken is given to the user when he starts working with the Domoscio API. This token must remain secret. To have access to Domoscio functionalities the user should follow these steps:
The AuthorizationToken should be used inside the Header of the request when calling the API for the first time & when the RefreshToken expires:
Authorization: Bearer < AuthorizationToken >
Inside the response Header, the AccessToken and RefreshToken will be given:
AccessToken: < AccessToken >
RefreshToken: < RefreshToken >
The RefreshToken should now be used in the header of the API request with the AccessToken. Here is an example on how to retrieve the AccessToken & RefreshToken:
Domoscio API uses conventional HTTP response codes to indicate the success or failure of an API request. In general:
|HTTP Status Code||Description|
|200 - OK||Everything worked as expected.|
|400 - Bad Request||The request was unacceptable, often due to missing a required parameter.|
|401 - Unauthorized||No valid Authentication Token provided.|
|404 - Not Found||The requested resource doesn't exist.|
|422 - Unprocessable Entity||The parameters were valid but the request failed, often due to already existing Objects with the input parameters.|
|500, 502, 503, 504 - Server Errors||Something went wrong on Domoscio API's end. Please contact the Domoscio support.|
A KnowledgeGraph (KG) is the first object to instantiate while setting up your content on our API. It is the top level of aggregation for knowledge nodes and edges. You can use it to describe your course, a book or even your whole knowledge map.