GET /buildings

Метод позволяет получить список зданий.

Переменные

Название Тип Формат Обязательность Описание
ids array Guid false Идентификаторы зданий
externalIds array ^\w{1,100}$ false Внешние идентификаторы зданий
token string string false Токен, после которого необходимо получить здания
count integer ^\d{1,50}$ false Количество зданий

В переменных запроса могут быть указаны либо идентификаторы зданий ids, либо токен и количество зданий. Если будет указан count >50, то он будет уменьшен системой до 50 в целях надежности.

Заголовки

Название Описание
Authorization Заголовок авторизации

Пример

Получение информации о здании

  GET /realty/web/inspection-api/v1/buildings?&token=942b0740-fa14-11ed-99b1-3fb8bbc6957f&count=3
  Authorization: ReestroAuth apiKey=1269f58a-3d40-42e1-91ad-a4251566419c&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c

Ответы

200

Тело ответа

{
    "items": [
        {
            "id": "fb303fdc-dcf0-11ed-a485-0fa37387fd5b",
            "externalId": null,
            "name": "ЖК Дубки",
            "type": "House",
            "address": "г. Оренбург, ул. Салмышская, 31",
            "districtId": "cdc95434-dcf0-11ed-a485-0fa37387fd5b",
            "period": {
                "from": "2023-04-24",
                "to": "2023-04-28"
            }
        },
        {
            "id": "e7119aac-4a8f-11ee-8d6f-c916aa292623",
            "externalId": null,
            "name": "1",
            "type": "House",
            "address": "Город Неизвестный, улица клозета д 24",
            "districtId": "9ae0b8c0-4a8f-11ee-8987-49ca91e99c86",
            "period": {
                "from": "2023-09-01",
                "to": "2023-11-30"
            }
        },
        {
            "id": "b792161e-489e-11ee-bd5b-11f3346da6a0",
            "externalId": null,
            "name": "2",
            "type": "House",
            "address": "ваыа",
            "districtId": "b6313cbe-489e-11ee-bd5b-11f3346da6a0",
            "period": null
        }
    ],
    "nextToken": "b792161e-489e-11ee-bd5b-11f3346da6a0"
}

401

Ошибка авторизации: пользователь не авторизован.

403

Ошибка аутентификации: пользователь не имеет доступа к ресурсам организации, которая указана в заголовке авторизации.