This is an archive version of the document. To get the most up-to-date information, see the current version.

Evaluation in Swagger UI

In this article

    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://<hostname>:<Port>/swagger/ui/index

    Where:

    • hostname 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:

    1. In Swagger UI, choose the API version v4 on top of the page.

    Evaluation in Swagger UI 

    1. Expand the Auth resource and click POST v4/token resource.
    2. For the grant_type parameter, make sure that password (default) value is chosen.
    3. 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!

    Evaluation in Swagger UI 

    Evaluation in Swagger UI Note:

    The client_id and assertion parameters are used in the scenario of data restore for Office 365 organizations with enabled security defaults. For more information, see Authorization for Organizations with Enabled Security Defaults.

    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.

    Evaluation in Swagger UI 

    Check that the access token is inserted in the api_key field in the Bearer <access_token> format and click Explore.

    Evaluation in Swagger UI 

    If the access token expires you can either obtain it again or renew using refresh token.

    To use the refresh token, perform the following steps:

    1. Expand the Auth resource and click POST /v4/token
    2. Select the refresh_token value in the grant_type drop-down list.
    3. Insert the refresh token in the refresh_token field
    4. Click Try it out!

    Evaluation in Swagger UI 

    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.

    Evaluation in Swagger UI 

    Getting Response

    The server will return the corresponding response to the successful request command.

    I want to report a typo

    There is a misspelling right here:

     

    I want to let the Veeam Documentation Team know about that.