GET /workers

Метод позволяет получить информацию о подрядчиках.

Переменные

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

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

Заголовки

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

Пример

Получение информации о подрядчиках

  GET /realty/web/inspection-api/v1/workers?count=2' 
  Authorization: ReestroAuth apiKey=1269f58a-3d40-42e1-91ad-a4251566419c&portal.orgid=1269f58a-3d40-42e1-91ad-a4251566419c

Ответы

200

Тело ответа

{
    "items": [
        {
            "id": "6b3c0dc4-5532-11ee-85f5-33cc3b23a326",
            "externalId": "1092028285",
            "organization": {
                "name": "Подрядчик 1",
                "inn": "9162433036",
                "ogrn": "1126623001625"
            },
            "soleProprietor": null,
            "notification": {
                "email": "string2@amail.ru",
                "phone": "79993738289"
            },
            "elementsIds": [
                "778378fc-52cf-11ee-9cf7-fd8814f00a4f",
                "31fff8f0-52bb-11ee-892c-e7c10b020b87"
            ]
        },
        {
            "id": "173aacca-53b7-11ee-8eb7-092cd17d6df0",
            "externalId": "1092028283",
            "organization": {
                "name": "Общество с ограниченной ответственностью Строим вместе",
                "inn": "7717658741",
                "ogrn": "1097746546512"
            },
            "soleProprietor": null,
            "notification": {
                "email": "strin339473g2@amail.ru",
                "phone": "79904738289"
            },
            "elementsIds": [
                "778378fc-52cf-11ee-9cf7-fd8814f00a4f"
            ]
        }
    ],
    "nextToken": "173aacca-53b7-11ee-8eb7-092cd17d6df0"
}

401

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

403

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