You can utilize Swagger UI to evaluate capabilities of Veeam Backup for Microsoft Office 365 RESTful API. The Swagger UI framework allows to interact with Veeam Backup for Microsoft Office 365 RESTful API in a sandbox UI. With such approach, you can test how the API responds to parameters and requests.
Swagger UI can be accessed via the Internet browser by the following URL:
https://<Backup-Office365>:<Port>/swagger/ui/index |
Where:
- <Backup-Office365> is the DNS name or IP address of the server where Veeam Backup for Microsoft Office 365 is installed.
- <Port> is the port number. Default: 4443.
Obtaining Authorization Token
To start working with Swagger UI, you must first authorize your access to Veeam Backup for Microsoft Office 365 RESTful API resources. Authorization process involves obtaining an authorization token that must be used in all requests during the session. To obtain an authorization token, perform the following steps:
- In Swagger UI click v1/token resource.
- For the grant_type parameter, make sure that password (default) value is chosen.
- For the username and password parameters enter the credentials for authenticating with the Veeam Backup for Microsoft Office 365 server and click Try it out!
Adding Authorization Token
Wait for the response from the server. A successfully completed operation returns response code 200, an access and a refresh token in the response body.
In the api_key field, insert the access token in the Bearer <access_token> format and click Explore.
If the access token expires you can either obtain it again or renew using refresh token.
To use a refresh token, go to v1/token resource, choose refresh_token as a value for the grant_type parameter, insert a refresh token and click Try it out!
Wait for the response from the server. A successfully completed operation returns response code 200 and a new pair of tokens in the response body.
Sending Request
Choose the resource and the request method, add parameters (if needed) and click Try it out! to send the request.
Getting Response
The server will return the corresponding response to the successful request command.