HTTP API Reference¶
The HTTP API allows you to integrate remote access and device management capabilities into your own services, applications, or internal systems. It enables you to automate work with devices, connections, users, and other platform entities without the need to perform actions manually in the control panel. The API is suitable for partners, developers, and companies that need to embed remote access functionality into their business processes or products.
Integration Example
Explore integration examples in the technician guides under the HTTP API section.
Requests¶
All requests must be made over the HTTPS (not HTTP) protocol with an appropriate method for each command at URL:
Authentication¶
API is RESTful: the server doesn't store the client connection state. That's why the client must send authorization data each time a request is sent. An API key is used as such data. Add the key in each request in the X-Api-Key HTTP header:
Where can I get an API key?
Your API key can be found in your personal profile in the Integration section of the HTTP API tab.
Responses¶
Data responses are returned in JSON UTF-8 with ContentType: application/json. Each response wraps data in the data JSON container.
The API server may return the following HTTP response codes:
| HTTP response code | Description |
|---|---|
200 OK | Request accepted and processed |
400 Bad Request | Request denied, invalid parameters, error |
402 Payment Required | Request rejected, request limit for the service plan exceeded |
403 Forbidden | Request denied, no access to data |
404 Not Found | Request denied, unknown request URL |
Available Methods¶
You can find detailed descriptions of the available methods on separate pages. For your convenience, we have grouped these methods by system function so that they match the structure of the control panel interface:
-
Permanent Access
Methods for managing devices, groups, and software.
-
Quick Support
Methods for managing customer invitations.
-
Connection History
Methods for retrieving information about the history of all connections.