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?

  1. Log into the Datto Partner Portal.
  2. Click the Admin tab, then select Integrations from the drop-down menu.
  1. On the Integrations page, make sure you are on the API Keys tab, and then press Create API Key
  1. 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
  1. The Datto REST API is now enabled, and configuration options will now appear.

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.

To change parameters and preview an API call:

  1. Click the Try it out button in the upper right-hand corner.
  1. Edit fields will open for each parameter. Make the changes you want, then click the Execute bar. to make the new API call.
  1. In the Responses pane beneath the Execute bar, you can view the Curl commands, request URL, HTTP code, response headers, and response code block generated by the preview API call. Click the Download button to download the code block as a JSON file. Click Clear to reset the API call preview.