Oбновление домофона

Метод и параметры

PATCH /api/v1/billing/intercoms

Для идентификации домофона используется либо ID, либо MAC-адрес. Использование обоих параметров одновременно не допускается.

JSON

{
    "group_external_id": "00000000-0000-0000-0000-000000000001",
    "flat_from": 1,
    "flat_to": 15,
    "new_serial_number": "new_serial_number",
    "mac": "AA:BB:CC:DD:EE:FF",
    "new_mac": "22:0D:CE:38:E7:15",
    "model": "3516EV200",
    "name": "intercom name",
    "department": 1,
    "log_extra": {
        "some": "information"
    }
}

Параметры метода

int id – ID домофона.

string mac – MAC-адрес домофона.

string title – название домофона.

integer flat_from – номер первой квартиры в диапазоне квартир, подключённых к домофону.

integer flat_to – номер последней квартиры в диапазоне квартир, подключённых к домофону.

integer group_id required – ID группы (адреса), в которую нужно поместить домофон.

string group_external_id – внешний ID группы (адреса). Используется вместо group_id.

string new_mac – новый MAC-адрес домофона.

string new_serial_number – новый серийный номер домофона.

string model – модель домофона. Обязательна при обновлении new_mac или new_serial_number.

string|array log_extra – дополнительная информация, получаемая из внешней системы.

array onvif_credentials – учетные данные для доступа к камере по ONVIF.

200 OK

Успешный ответ с данными обновленного домофона

JSON

{
    "id": 123,
    "external_id": "EXT_123",
    "department": "main",
    "title": "Новое название",
    "mac": "22:22:22:22:22:22",
    "model": "DKS20211",
    "serial_number": "NEW_SERIAL_123",
    "status": "installed",
    "flat_from": 1,
    "flat_to": 100,
    "source": "auto-replace",
    "group": {
        "id": 6,
        "name": "4",
        "external_id": "0e4bbda6-b7a5-4db4-8178-315bf0006d11",
        "has_items": false
    }
}

422 Unprocessable Entity

Возвращает JSON-объект с ошибкой. Детально в разделе Общая информация→Валидация.

JSON

{
    "message": "Сообщение отсутствует",
    "errors": {
        "any_key": [
            "Детальная информация об ошибке"
        ]
    }
}

cURL

Bash

curl -k --request PATCH \
	--url 'https://your-domain/api/v1/billing/intercoms' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "id": 0,
    "mac": "string",
    "title": "string",
    "flat_from": "integer",
    "flat_to": "integer",
    "group_id": "integer",
    "group_external_id": "string",
    "new_mac": "string",
    "new_serial_number": "string",
    "model": "string",
    "log_extra": "string|array",
    "onvif_credentials": []
}'

PHP

$data = array (
  'id' => 0,
  'mac' => 'string',
  'title' => 'string',
  'flat_from' => 'integer',
  'flat_to' => 'integer',
  'group_id' => 'integer',
  'group_external_id' => 'string',
  'new_mac' => 'string',
  'new_serial_number' => 'string',
  'model' => 'string',
  'log_extra' => 'string|array',
  'onvif_credentials' => 
  array (
  ),
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'PATCH',
		'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);