This document explains how to use this REST API to send requests to the ADOXX-based product using the desired authentication mechanism.
ADOXX RESTful services are based on "JAX-RS", a programming language API which facilitates creating a RESTful interface. ADOXX-based products use JAX-RS' reference implementation "Jersey".
Jersey is very well documented, and contains elaborate Jersey API documentation
The addresses for RESTful services exposed by ADOXX-based products
use the following pattern:
Where everything before
[service path] is the fixed path and the part(s) afterwards are defined by the service.
You are configuring ADOXX. You are running the ADOXX
web application locally. The ADOXX web application exposes a REST
service called "helloworld". The URL should look like this:
For testing purposes, the following URLs are always available:
(requires authentication - see Authentication)
The REST API Specification is documented with the standard Open API Specification (OAS).
Based on the OAS definition the developer portal provides a frontend for each API endpoint that shows the documentation and how to use the API.
We provide a comprehensive overview of REST API endpoints which shows the documentation
In addition all endpoints can be retrieved by accessing the
Getting started with REST API
BOC products offer a generic and extensible REST API that allows autehnticated acces to exposed functionality. The REST API can be used to e.g. send GET request to query for data.
Instructions on how to activate and configure access to the REST API are covered in the Administration Manual.
OR get started right away by using any of BOC's cloud solutions. REST is coming to the Community Edition products soon!
This example shows how to retrieve all available repositories by using the
Use any of the built-in Swagger documentation to find interesting endpoints. For this example the Repository Read Endpoint is chosen.
There are many methods to try out endpoints. Untill try it out functionality in the web browser is enabled we will demonstrate how to call the endpoints through Postman. To perform a REST call, make sure to fill out the properties as described below:
HTTP Method: Select GET, POST, PUT, PATCh or DELETE in the dropdown menu next to the Base URL
Base URL: Enter the base URL for the web ervice endpoint.
Resource Path: Enter the path to the complete web service endpoint. In the example below we aim to retrieve a list of all repositories. The endpoint for that is
Query Parameters: Undereath the Base URL input a tab presents itself called Params. Optionally for certain endpoints one could append parameters to the call.
Authorization: Underneath the Base URL input, and next to the Params tab it is required to select
Basic Auth. The authorization header will be automatically generated when you send the request. Fill in the Username field and the Password field according to your credentials used to log in to the application.
Response: After clicking send, an response should be returned. In the example below we obtain a json containing a list of repositories.
We will soon enable a "try it out" functionality with basic authentication to allow you to test the APIs directly.
ADOXX RESTful services support three authentication mechanisms:
- Token Based Authentication Each request is accompanied by Hashed security token to ensure validity of the request. Requests are executed in the context of a technical user.
- Basic authentication: Each request contains the header
"Authorization" where the value is the username and password
separated by a single colon
(:)character, within a base64 encoded string. Requests may be executed in the context of any standard product user.
- OAuth 2.0: Each request is accompanied by an access token to ensure validity of the request. Requests may be executed in the context of any standard product user.