Вакансии

Атрибут	Значение
Название	info-radar-vacancy
Тип	Адаптер для получения информации по вакансиям
Наименование	Вакансии
Версия	Реализовано 21.07.2025

Сервис для получения информации по вакансиям.

Общая информация

Цель документации — обеспечить полное понимание и возможность эффективного использования сервиса как для конечных пользователей, так и для разработчиков.

Сервис является частью платформы Агредатор. Перед изучением данной документации ознакомьтесь со следующими обязательными документами по интеграции с платформой:

Параметр	Название	Тип	Обязательное	Пример
service	Имя сервиса (всегда `info-radar-vacancies`)	string	+	info-radar-vacancies
type	Тип запроса	string (enum)	+	vacancies
data	Данные запроса	object	+	см. ниже

Типы запросов type

type	Значение
list	Получение информации по вакансиям

Структура data

Параметр	Название	Тип	Обязательное	Пример
EntityId	Идентификатор лица	string (uuid)	+	"3fa85f64-5717-4562-b3fc-2c963f66afa6"
EntityType	Тип лица	string	+	"Company"
Status	Статус вакансии	string	-	"Open"
SalaryRange	Диапазон зарплаты	string	-	"50000-100000"
PublicationMonth	Месяц публикации вакансии	string	-	"2025-07"
OrderBy	Сортировка	string	-	"DateDescending"
Page	Номер страницы	integer	-	1

Структура элементов data

EntityId

Описаниe: Идентификатор лица.
Тип данных: string (uuid)
Обязательное: +
Пример: 3fa85f64-5717-4562-b3fc-2c963f66afa6

EntityType

Описаниe: Тип лица (например, компания, физическое лицо и т.п.).
Тип данных: string
Обязательное: +
Пример: Company
Возможные значения: Company, Person, ForeignCompany, Entrepreneur, MunicipalSubject

Status

Описаниe: Статус вакансии.
Тип данных: string
Обязательное: -
Пример: Open
Возможные значения: Open, Closed, Expired

SalaryRange

Описаниe: Диапазон предлагаемой зарплаты.
Тип данных: string
Обязательное: -
Пример: 50000-100000

PublicationMonth

Описаниe: Месяц и год публикации вакансии.
Тип данных: string (формат "YYYY-MM")
Обязательное: -
Пример: 2025-07

OrderBy

Описаниe: Параметр сортировки результатов (например, по дате от меньшего к большему или наоборот).
Тип данных: string
Обязательное: -
Пример: DateDescending
Возможные значения: DateAscending, DateDescending

Page

Описаниe: Номер страницы для постраничного получения данных.
Тип данных: integer
Обязательное: -
Пример: 1

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

Параметр	Название	Обязательное	Тип	Пример
success	Статус запроса	+	string	true
result	Хеш с результатом	-	object	См. ниже
exception	Ошибка	-	string	Что-то пошло не так

Параметры result

Поле	Назначение	Тип	Обязательное	Пример
Aggregations	Агрегационные данные	object	-	Составной элемент Aggregations
TotalItems	Общее число элементов	integer	-	0
Items	Массив дел	array[object]	-	Items

Структура элемента `Aggregations`

Поле	Назначение	Тип	Пример
(например Status)	Имя агрегационной группы	array[object]	элемент Aggregations

Элемент массива

Items

Поле	Назначение	Тип	Пример
Title	Название вакансии	string	"Программист .NET"
Requirements	Требования к кандидату	string	"Знание C#, опыт работы 2 года"
Responsibilities	Обязанности по вакансии	string	"Разработка, поддержка ПО"
Conditions	Условия работы	string	"Официальное трудоустройство"
Employment	Вид занятости	string	"Полная занятость"
Schedule	График работы	string	"Понедельник - пятница"
SalaryMin	Нижняя граница зарплаты	integer	50000
SalaryMax	Верхняя граница зарплаты	integer	80000
SalaryRange	Диапазон зарплаты (категория)	string	"Unspecified"
City	Город размещения вакансии	string	"Москва"
Address	Адрес места работы	string	"ул. Ленина, д. 10"
PublicationDate	Дата публикации вакансии	string (date-time)	"2025-08-08T08:37:02.125Z"
Archived	Признак архивной вакансии (удалена/архив)	boolean	true
Portal	Название портала публикации	string	"HeadHunter"
Url	Ссылка на вакансию	string	"https://example.com/vacancy/123"

Aggregations

Поле	Назначение	Тип	Пример
(например SalaryRange)	Имя агрегационной группы	array[object]	См. ниже NestedAggregations

NestedAggregations

Поле	Назначение	Тип	Пример
NestedAggregations	Вложенные агрегации по ключу	array[object]	См. выше Aggregations
Value	Значение по ключу агрегации	string	"FromFifty"
Name	Название категории или признака	string	"От 50 до 100 тыс. руб."
Count	Количество элементов	integer	2442

Пример json запроса

{
  "service": "info-radar-vacancies",
  "type": "vacancies",
  "data": {
    "EntityId": "34f0e4b2-1553-4880-bbe2-853f65ed65f3",
    "EntityType": "Company",
    "SalaryRange": "50000-100000",
    "PublicationMonth": "2025-07",
    "OrderBy": "DateAscending",
    "Page": 1
  }
}

Примеры json ответов

{
  "success": true,
  "result": {
    "Aggregations": {
      "SalaryRange": [
        {
          "NestedAggregations": {
            "PublicationMonth": [
              {
                "NestedAggregations": {
                  "Status": [
                    {
                      "NestedAggregations": {},
                      "Value": "Actual",
                      "Name": "Активные вакансии",
                      "Count": 4
                    }
                  ]
                },
                "Value": "2019-06-01T00:00:00",
                "Name": null,
                "Count": 4
              }
            ],
            "Status": [
              {
                "NestedAggregations": {
                  "PublicationMonth": [
                    {
                      "NestedAggregations": {},
                      "Value": "2019-06-01T00:00:00",
                      "Name": null,
                      "Count": 4
                    }
                  ]
                },
                "Value": "Actual",
                "Name": "Активные вакансии",
                "Count": 44
              }
            ]
          },
          "Value": "FromHundredFifty",
          "Name": "От 150 тыс. руб. и выше",
          "Count": 44
        }
      ],
      "PublicationMonth": [
        {
          "NestedAggregations": null,
          "Value": "2019-10-01T00:00:00",
          "Name": null,
          "Count": 2182
        }
      ],
      "Status": [
        {
          "NestedAggregations": null,
          "Value": "Actual",
          "Name": "Активные вакансии",
          "Count": 22044
        }
      ]
    },
    "TotalItems": 22044,
    "Items": [
      {
        "Title": "Инженер электросвязи",
        "Requirements": "Требуемый опыт работы: 1\r\nОбразование: Среднее профессиональное\r\nКвалификация: Высшее профессиональное (Техническое) образование либо имеющее среднее профессиональное (Техническое) образование и стаж работы не менее 1 года. Знание видов телекоммуникационного оборудования электросвязи, его назначение и характеристики; видов оконечного оборудования, их функциональность и необходимую конфигурацию оборудования, включая оборудование клиента, для предоставления услуг связи.  Внимательность. Согласно ТК РФ.",
        "Responsibilities": "Выполнение должностных обязанностей в соответствии с должностной инструкцией.",
        "Conditions": null,
        "Employment": "Полная занятость",
        "Schedule": "Неполный рабочий день",
        "SalaryMin": 21816,
        "SalaryMax": null,
        "SalaryRange": "FromTwenty",
        "City": null,
        "Address": "г Сургут",
        "PublicationDate": "2019-03-03T21:00:00",
        "Archived": false,
        "Portal": "https://rabota.ru",
        "Url": null
      },
      {
        "Title": "Инженер электросвязи",
        "Requirements": "Требуемый опыт работы: 1\r\nОбразование: Среднее профессиональное\r\nКвалификация: Высшее профессиональное (Техническое) образование либо имеющее среднее профессиональное (Техническое) образование и стаж работы не менее 1 года. Знание видов телекоммуникационного оборудования электросвязи, его назначение и характеристики; видов оконечного оборудования, их функциональность и необходимую конфигурацию оборудования, включая оборудование клиента, для предоставления услуг связи.  Внимательность. Согласно ТК РФ.",
        "Responsibilities": "Выполнение должностных обязанностей в соответствии с должностной инструкцией.",
        "Conditions": null,
        "Employment": "Полная занятость",
        "Schedule": "Неполный рабочий день",
        "SalaryMin": 24316,
        "SalaryMax": null,
        "SalaryRange": "FromTwenty",
        "City": null,
        "Address": "628012, г Ейск, ул Коминтерна, д. 3",
        "PublicationDate": "2019-03-03T21:00:00",
        "Archived": false,
        "Portal": "https://rabota.ru",
        "Url": null
      }
    ]
  }
}

Пример ошибки:

{
  "success": false,
  "exception": "Что-то пошло не так"
}