Remove an intercom by an external system

The method and parameters

When an intercom is deleted, it undergoes a soft delete:

The intercom's status is changed to deleted.
The associated apartments (intercom_flats) are deleted.
If a camera is connected, it is also deleted, but its video recording archive is retained.

Deletion by ID:

JSON

{
    "id": "123",
    "log_extra": {
        "some": "information"
    }
}

Deletion by MAC:

JSON

{
    "mac": "11:11:11:11:11:11",
    "log_extra": {
        "some": "information"
    }
}

DELETE /api/v1/billing/intercoms

int id – the intercom ID.

string mac – the MAC address of the intercom.

string|array log_extra – additional information received from an external system.

204 No Content

A successful response

422 Unprocessable Entity

Returns a JSON object with an error. For details, see General information/External system validation.

JSON

{
    "message": "No error message here",
    "errors": {
        "any_key": [
            "Error details"
        ]
    }
}

cURL

Bash

curl -k --request DELETE \
	--url 'https://your-domain/api/v1/billing/intercoms' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "id": 0,
    "mac": "string",
    "log_extra": "string|array"
}'

PHP

$data = array (
  'id' => 0,
  'mac' => 'string',
  'log_extra' => 'string|array',
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'DELETE',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/v1/billing/intercoms', false, $context);