The REST API allows other applications to directly access data provided by BellaDati and is the underlying interface for our mobile Business Intelligence BellaDati Piccolo. Through the API, users can retrieve reports, charts and even entire dashboards to integrate with their own custom client application.
Before you can access the REST API, you need to enable it in your domain configuration.
The base address to access the REST API is https://service.belladati.com/api/
.
If you are using an on-premise deployment, it is https://your-server/belladati/api/
.
All API requests to BellaDati cloud service must be sent over SSL.
With an on-premise deployment, although not mandatory, we strongly recommend using SSL for security reasons.
Every string passed to and from the BellaDati REST API needs to be UTF-8 encoded. For maximum compatibility, normalize to Unicode Normalization Form C (NFC) before UTF-8 encoding.
BellDati REST API uses the locale parameter to specify language settings of content responses. If you want to retrieve data in a language other than English, insert the appropriate IETF language tag. When a supported language is specified, BellaDati will return translated content where applicable.
The BellaDati REST API uses the JSON format for any responses to API calls. And additionaly some responses can return HTML and PNG format for pictures.
Errors are returned using standard HTTP error code syntax. Any additional info is included in the body of the return call in JSON format. Error codes not listed here are described in the respective REST API method.
Standard API HTTP errors are:
Code | Description |
---|---|
400 | Bad input parameter. Refer to the error message to find out which one and why. |
401 | Bad or expired token. This can happen if the access token has expired or is otherwise invalid. To fix this, re-authenticate the user. |
403 | Bad OAuth request (incorrect consumer key, bad nonce, expired time stamp...). Refer to the error message for details. |
404 | File or folder not found at the specified path. Check if the URL you're trying to access is correct. |
405 | Unexpected request method. The request method should be GET or POST depending on the request you're trying to make. |
503 | Your app is making too many requests and is being rate limited. 503s can trigger on a per-app or per-user basis. |
5xx | Server error. Refer to the error message for details. |
Application runtime errors are:
Code | Description |
---|---|
request_token_unauthorized | Bad input parameter. Refer to the error message to find out which one and why. |
request_token_rejected | Bad or expired token. This can happen if the access token has expired or is otherwise invalid. To fix this, re-authenticate the user. |
access_token_already_issued | Bad OAuth request (incorrect consumer key, bad nonce, expired time stamp...). Refer to the error message for details. |
invalid_consumer | File or folder not found at the specified path. Check if the URL you're trying to access is correct. |
request_token_not_found | Unexpected request method. The request method should be GET or POST depending on the request you're trying to make. |
token_not_found | Your app is making too many requests and is being rate limited. 503s can trigger on a per-app or per-user basis. |
token_unauthorized | Server error. Refer to the error message for details. |
parameter_absent | |
user_not_found | |
too_many_login_failures | |
user_login_failed | |
user_not_active | |
user_expired | |
no_domain | |
domain_expired | |
api_disabled |