Interactive Api
Dangl.AVACloud features a fully interactive online documentation of the API that you can try out directly from your web browser. It's leveraging the Open Api format, formerly known as Swagger, to provide a standardized API documentation. You can automatically generate client libraries for many languages - Java, C++, Rust, Go, Python, JavaScript and many more. In fact, the official AVACloud .NET Client, Dangl.AVACloud.Client is automatically generated.
There are two endpoints:
- https://avacloud-api.dangl-it.com/swagger with access to GAEB and Excel conversion functions
- https://avacloud-api.dangl-it.com/swagger-internal with access to the full API
Both endpoints are publicly browsable. However, the full API also returns Dangl.AVA data objects that require the GAEB & AVA .Net Libraries for extended functionality, otherwise they're just plain objects.
Accessing the API in your Browser
When you have opened the API documentation site, you have to log in to AVACloud for API access. Please click
the Authorize
button in the upper right corner and log in with your Dangl.Identity account. Make sure to
select the avacloud
scope at the bottom of the dialog, otherwise the authorization attempt will fail.
Your user account must have access to the AVACloud services. You can do this via the developer signup, or alternatively you can contact DanglIT to grant you permission.