Using the Datto REST API With Datto device Integrations
Topic
This article describes setting up and using the REST API with Datto device integrations.
Environment
- Datto Partner Portal
- Datto REST API
Description
Datto's new REST API lets vendors create a dynamic integration experience in a more reliable and scalable way. It is also available for MSPs that have an experienced technical background.
Creating an integration with Datto's REST API provides an easy way to retrieve readily available device, agent, and backup status information. The Datto REST API uses the industry-standard Swagger UI for an interactive documentation experience that allows developers to trial responses from their own devices on their portal accounts.
How do I access the API Configuration Options?
- Log into the Datto Partner Portal.
- Click the Admin tab, then select Integrations from the drop-down menu.
- On the Create API Key pane, provide a name for your API key and fill out any other fields as needed, and then press Create
REST API Configuration options
- View keys: Displays public and private key(s)
- Edit: Brings up the Edit API screen
- Regenerate Key: generates a new public API key
- Deactivate: disables the Datto REST API
- Delete: Deletes created API key
- Try it out: Populates the REST API documentation with public and private key for testing purposes
- Reveal: displays the secret key's actual characters on-screen
Accessing Datto REST API documentation
Click the Documentation button in the REST API options pane. The pane will expand and open the API documentation, including basic API options and options for the individual endpoints.
REST API documentation pane options
- Authorize: The REST API uses a basic authentication scheme, with an automatically generated public API key/secret API key.
- Servers: This drop-down menu shows what server the API is currently communicating with, and lets you select different available servers.
REST API endpoint options
The REST API documentation provides a menu of all configurable endpoints. You can use the Try It Out button to change parameters within each endpoint:
Click an endpoint to expand its options.
The endpoint will expand, showing all parameters accepted in the URL, as well as the JSON representation of the responses from the server.
Previewing API call results with the Swagger UI
The swagger UI lets you change endpoint parameters, run "preview" API calls, and view detailed results of the change at the presentation and code levels. In this view, you can:
- change each parameter and get a preview of the change's effect
- see the responses generated by each preview request as a Curl command and URL
- see the HTTP response codes generated when the server responds to the API call preview
- download the JSON code block generated by your trial API calls
A Datto device must be associated with the Partner Portal account for these options to function.