To be able to use the Vainu API you need a valid Vainu license with API permissions included. Licenses may have limitations as to which databases or datasets are available. Please contact your Vainu representative for further questions regarding licenses.
Using Vainu API requires authentication either by an API Key or traditional HTTP basic access.
API keys can be obtained from the Vainu Platform. In the Vainu platform, you can create, disable and manage your API keys. API key management can be found in the Settings, in the 'API Keys' section of the platform. The maximum amount of simultaneous active API keys is three per account.
The API key is used as an API key header in the request.
Basic access authentication – commonly referred to as "basic auth" or HTTP authentication – uses the same login credentials as the web interface. For Basic access, you need to use an Authorization header with a base64 encoded username and password.
Authorization: Basic <base64(username:password)>
API Trials are authenticated with JWT tokens. These tokens offer limited access to the API for a limited amount of time.
With upcoming releases, full support of JWT authentication will be included in Vainu API.
Updated almost 2 years ago