Zoho Recruit

Интеграция с API Zoho Recruit через управляемую OAuth-аутентификацию позволяет полноценно работать с процессами подбора персонала: управлять кандидатами, вакансиями, интервью и заявками. Решение поддерживает полный набор CRUD-операций и подходит для автоматизации рекрутинга.

Быстрый старт

Простейший пример — получение списка кандидатов через API:

import urllib.request, os, json

req = urllib.request.Request(
 'https://gateway.maton.ai/zoho-recruit/recruit/v2/Candidates?per_page=10'
)
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')

print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))

Базовый URL

Все запросы выполняются через единый шлюз:

https://gateway.maton.ai/zoho-recruit/{native-api-path}

Замените {native-api-path} на конкретный путь API Zoho Recruit. Шлюз автоматически проксирует запросы и подставляет OAuth-токен.

Аутентификация

Для всех запросов требуется API-ключ Maton:

Authorization: Bearer $MATON_API_KEY

Переменная окружения:

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

• Зарегистрируйтесь или войдите в аккаунт на maton.ai
• Перейдите в настройки
• Скопируйте ваш API-ключ

Управление подключениями

Подключения Zoho Recruit управляются через отдельный сервис. Вы можете создавать, просматривать и удалять OAuth-сессии.

Список подключений

GET https://ctrl.maton.ai/connections?app=zoho-recruit&status=ACTIVE

Создание подключения

POST https://ctrl.maton.ai/connections

После создания откройте URL авторизации в браузере для завершения OAuth-процесса.

Работа с API

Модули

Система поддерживает множество модулей: кандидаты, вакансии, интервью, заявки, отделы и другие сущности.

Кандидаты

Основные операции:

• Получение списка кандидатов
• Получение кандидата по ID
• Поиск по критериям
• Создание нового кандидата
• Обновление данных
• Удаление записей

Пример создания кандидата

{
 "data": [
 {
 "First_Name": "John",
 "Last_Name": "Doe",
 "Email": "john.doe@example.com",
 "Phone": "555-123-4567"
 }
 ]
}

Вакансии

API позволяет управлять вакансиями: создавать, обновлять, получать список и удалять позиции.

Интервью

Можно работать с интервью: планировать встречи, получать данные и управлять процессом отбора.

Универсальные операции

Все модули поддерживают единый набор действий:

• GET — получение записей
• POST — создание
• PUT — обновление
• DELETE — удаление
• SEARCH — поиск

Доступные модули

• Кандидаты (Candidates)
• Вакансии (Job Openings)
• Заявки (Applications)
• Интервью (Interviews)
• Отделы (Departments)
• Клиенты и контакты
• Кампании и задачи

Пагинация

API использует постраничную навигацию:

?page=1&per_page=200

Максимум — 200 записей за запрос.

Особенности и ограничения

• ID записей представлены строками чисел
• Фамилия обязательна для кандидатов
• Максимум 200 записей в GET-запросе
• До 100 записей в POST/PUT/DELETE
• Форматы дат — ISO 8601
• Имена модулей чувствительны к регистру

Обработка ошибок

Основные коды:

• 400 — ошибка запроса или отсутствует подключение
• 401 — неверный API-ключ
• 429 — превышен лимит
• 5xx — ошибки со стороны Zoho

Типовые ошибки

• INVALID_DATA — неверные данные
• MANDATORY_NOT_FOUND — отсутствует обязательное поле
• DUPLICATE_DATA — дубликат записи
• NO_PERMISSION — недостаточно прав

Итог

Интеграция Zoho Recruit через API-шлюз позволяет выстроить гибкую автоматизацию процессов найма. Благодаря единому интерфейсу и поддержке всех ключевых операций, инструмент подходит как для простых сценариев, так и для масштабных HR-систем.