The callback handler

To manage communication and data exchange between the Acronis platform and your cloud service, you must create a callback handler.

A callback handler is an API endpoint that accepts HTTP requests (called callbacks) from the Acronis Cyber Platform’s API Callback Gateway, processes them according to the specified format, sends the corresponding action to be executed by your service, and returns the operation result.

  • The Acronis Cyber Platform’s API Callback Gateway receives an HTTP request from a user and sends it to your callback handler URL.

  • Your callback handler receives the HTTP request from Acronis API Callback Gateway and responds in a specific format.

Note

For more information on callbacks, see the callbacks chapter.

Simplified flow

../_images/fig-api_callbacks_structure.png

Basic requirements

The callback handler has the following basic requirements:

  • It must be implemented in a web service that will accept HTTP requests from the Acronis API Callback Gateway.

  • A web service, where the callback handler endpoint is implemented, must support HTTPS protocol with TLS v1.3.

  • It must be publicly accessible.

  • The domain name of the callback handler must have a valid SSL certificate issued by a trusted authority, such as GoDaddy, Comodo, Let’s Encrypt, or GlobalSign.

  • It must accept incoming requests, and respond with JSON data according to the callback configuration defined in CyberApp Standard.

In this section