История версий

v1 — 2026-08-06

Первая версия. Выгрузка вакансий и кандидатов, приём откликов и рефералов, сервисные ключи с областями доступа.

Что считается ломающим изменением

В пределах v1 мы можем:

• добавить поле в ответ;
• добавить необязательный параметр запроса;
• добавить новый метод;
• добавить значение в перечисление — например, новый статус вакансии.

И не будем:

• переименовывать или убирать существующее поле;
• делать необязательный параметр обязательным;
• менять смысл поля, оставив его имя.

Отсюда правило для клиента: не падайте на незнакомом поле в ответе и на незнакомом значении перечисления. Появится v2 — она будет отдельным путём, и v1 продолжит работать.

Известные ограничения

Эти вещи в v1 отсутствуют осознанно, а не по недосмотру:

• Вебхуков нет. Реализована модель pull: вы ходите к нам по расписанию. Push потребовал бы машинерии повторов и очередей на нашей стороне ради выигрыша в минуты.
• Удаления не распространяются. Обходной путь описан в разделе синхронизации.
• Файла резюме нет. Причины — в разделе кандидатов.
• Дубли людей не склеиваются. Причины — в разделе приёма откликов.

Если что-то из этого мешает — скажите, это входные данные для следующей версии.