Introducing API v2 & getting started
API version 2 is the latest version of eMabler REST API. API v2 is designed to be faster, more easy to use and more scalable with larger amounts of data. Support for pagination and self managed API keys are added to API v2 when compared to API version 1. Connect is also built completely on top of API v2, so everything possible on there can be achieved by using these APIs.
Getting started
Most of the APIs should be stable to use, but please note that we reserve the right to do breaking changes on the endpoints during beta if necessary. If such changes need to be done, those will be notified on advance.
Environments
API v2 is available in the following environments
| Environment | URL |
|---|---|
| TEST | https://new-api.emabler.net/api/ |
| STAGING | https://new-api-staging.emabler.net/api/ |
| PRODUCTION | https://new-api.emabler.io/api/ |
Authentication
To authenticate you first need to generate yourself an API key. To do that, you need access to Connect. With API v2 API keys are created via self service from Connect, so if you want access to Connect please contact customer service.
API keys can be created in Connect from Settings > Developer > Add API key.
Please store the API key in a secure place after creation as it cannot be accessed later from Connect.
Using the API key
API keys used for API v2 don't work with previous versions of the API. Older keys don't also work with the new version of the API. Please generate new API key from Connect if you wish to access API v2
Once API key is acquired, you can start calling the endpoints by adding the API key to x-api-key header.
Example curl to GET /sites in TEST:
curl -X GET "https://emablerapi-v2-entitymanagement-test.azurewebsites.net/api/v2/sites" -H "accept: application/json" -H "x-api-key: <API KEY>"
About permissions
API key will inherit the permission the operator has who has created the API key. API will respond with an error message telling which permissions are needed for the current endpoint if your operator account is missing said permissions.
API Documentation
APIs are documented in the following pages. Please check all the available endpoints to see what is possible with API v2!
API Endpoint documentation has demo functionality built-in, so you can test the APIs directly from the documentation with your API key.
You may also download the OpenAPI description and use for example Postman for testing the API.
https://emablerapi-v2-entitymanagement-test.azurewebsites.net/api/swagger.json