Reading MSP’s customers from your service

When the MSP administrator accesses the Acronis Management Portal for customer mapping, API Callback Gateway sends a POST request to the callback handler asking for the list of MSP’s customers in your service.

The callback request will:

  • Specify the cti.a.p.acgw.callback.v1.0~a.p.topology.read.v1.0 callback identifier.

  • Specify the cti.a.p.acgw.request.v1.0~a.p.topology.read.v1.0 callback request type.

This request can be represented with the following cURL command:

curl -i -s -X POST <callback_handler_url> \
    --header 'Content-Type: application/json' \
    --header 'X-CyberApp-Auth: base64(<identity>:<secret>)' \
    --header 'X-CyberApp-Extra: base64(<json_extra_data>)' \
    --data '{"type": "cti.a.p.acgw.request.v1.0~a.p.topology.read.v1.0", "request_id": "<request_id>", "payload": {}, "created_at": "2023-04-10T15:33:01+00:00", "context": {"callback_id": "cti.a.p.acgw.callback.v1.0~a.p.topology.read.v1.0", "endpoint_id": "<endpoint_id>", "tenant_id": "<acronis_tenant_id>", "datacenter_url": "<acronis_datacenter_url>"}}'

The callback response code must be 200 and the response body must:

  • Specify the cti.a.p.acgw.response.v1.0~a.p.topology.read.ok.v1.0 response type.

  • Include the payload field with the list of MSP’s customers in your service.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
<...>

{
    "type": "cti.a.p.acgw.response.v1.0~a.p.topology.read.ok.v1.0",
    "request_id": "<request_id>",
    "response_id": "<response_id>",
    "payload": {
        "items": [
            {
                "id": "<vendor_customer_organization_id>",
                "name": "<vendor_customer_name>"
            }
        ]
    }
}