Breadcrumbs

Создание элемента дерева

Есть два типа дерева, для камер и для домофонов.

При создание элементов можно указывать собственный ключ, по которому можно ссылать на этот элемент. Эти ключи должны быть уникальны в рамках одного типа дерева.

При создания подэлемента в дереве, можно присылать как id из нашей БД, так и ключ, который указывается при создании.

Элемент дерева не может одновременно содержать подэлементы и конечные объекты.

После создания корневого элемент дерева, он станет доступен администраторам, у которых есть доступ к Синхронизация корневых элементов дерева пользователю (groups-root-sync)




POST/api/v1/billing/tree

Headers

Accept

application/json

Body

json
JSON
{
    "name": "new name",
    "type": "cameras|intercoms",
    "external_id": null,
    "parent_external_id": null,
    "parent_id": null
}

namerequired

string

Название элемента дерева

typerequired

string

Тип дереве

external_idrequired

string|int

Ключ для элемента дерева

parent_idrequired

int

Необходим для создания подэлемента в дереве через id в нашей БД

parent_external_idrequired

string|int

Необходим для создания подэлемента в дереве через уникальный ключ, указанный при его создании

Response




201

Успешный ответ
JSON
{
                "id": 15,
                "name": "Name of item",
                "external_id": "unique_key",
                "has_items": false
            }




422

Возвращает JSON объект с ошибкой, см. Валидация
JSON
{
    "message": "Тут не будет информативного сообщения",
    "errors": {
        "any_key": [
            "Тут будет описана причина ошибки"
        ]
    }
}

Пример
JSON
curl -k --location --request POST 'https://vms.local/api/v1/billing/tree' \
--header 'Accept:application/json' \
--header 'Content-Type: application/json \
--data-raw '{
    "name": "new name",
    "type": "cameras|intercoms",
    "external_id": null,
    "parent_external_id": null,
    "parent_id": null
}'