Перейти до змісту
JOBSON, програма для кадрових агентств
Реєстрація

REST API в ціні · MCP з доплатою Power

API і MCP-сервер JOBSON 3

Надсилайте кандидатів із власного сайту, синхронізуйте картотеку з іншою системою або під’єднайте JOBSON до Claude чи ChatGPT.

Зареєструватися й отримати API-ключДокументація OpenAPI (відкриється в новому вікні)

Документація доступна адміністратору агентства після входу.

JOBSON 3 має REST API для набору й картотеки осіб і MCP-сервер для AI-клієнтів Claude і ChatGPT.REST API входить у ціну без доплати й без квоти. Автентифікація — API-ключем агентства, помилки повертаються згідно з RFC 9457. MCP-сервер входить у доплату Power. Документація OpenAPI доступна в застосунку після входу.

REST API
набір, картотека осіб · входить у ціну · без квоти
MCP
Claude, ChatGPT · доплата Power · від 10 000 до 50 000 викликів на місяць
Автентифікація
Bearer API-ключ агентства з областями доступу (scopes)
Помилки
RFC 9457 (problem+json)
Документація
OpenAPI в застосунку для адміністратора агентства

REST API

Типове використання: форма на кар’єрному сайті агентства надсилає кандидатів одразу в JOBSON або картотека регулярно синхронізується з іншою системою.

Набір

4 ендпоінти

  • POST/api/recruitment/inbound

    надсилає кандидата в чергу «Вхідні» (перевірка дублікатів, джерело, згода GDPR)

  • GET/api/recruitment/vacancies

    список вакансій

  • GET/api/recruitment/candidacies?zakazka={id}

    здобувачі у вакансіях

  • GET/api/recruitment/hired?od={YYYY-MM-DD}

    прийняті кандидати

Картотека осіб

5 ендпоінтів

  • POST/api/v1/people

    створює або оновлює осіб (upsert)

  • GET/api/v1/people

    експорт осіб

  • GET/api/v1/people/schema

    схема полів, зокрема власних полів агентства

  • GET/api/v1/people/{internal_number}

    одна особа за внутрішнім номером

  • GET/api/v1/import-runs/{id}

    стан імпорту

Доплата Power

MCP-сервер для Claude і ChatGPT

MCP (Model Context Protocol) — відкритий стандарт для під’єднання AI-асистентів до застосунків. JOBSON має власний MCP-сервер, тож ви під’єднуєте його до Claude або ChatGPT як конектор, і асистент працює з даними агентства через ті самі інструменти, що й AI-асистент у застосунку.

  • Endpoint

    POST /mcp

  • Токен прив’язаний до людини

    Його створює користувач, який має відповідний дозвіл у застосунку. Токен може права лише обмежити, ніколи не розширити. Термін дії — 30, 90 або 365 днів.

  • Запис лише з явного дозволу

    Без нього токен дані лише читає.

  • Квоти доплати Power

    10 000 / 20 000 / 50 000 викликів інструментів на місяць. initialize, ping і tools/list не враховуються. Після 90 % надходить попередження, після вичерпання квоти виклик відхиляється.

  • Кредити

    AI-операції, які запускають інструменти, оплачуються кредитами так само, як у застосунку.

  • Журнал

    Кожен виклик можна відстежити в історії змін.

Автентифікація та помилки

REST API використовує API-ключ агентства в заголовку Authorization: Bearer. Ключ створює адміністратор у налаштуваннях набору або імпорту, і він завжди належить до однієї групи областей доступу (scopes). Помилки API повертає у форматі RFC 9457 з кодом і ключем повідомлення.

bashВигаданий ключ · приклад
curl -X POST https://my.jobson.cloud/api/recruitment/inbound \  -H "Authorization: Bearer jb_live_XXXX" \  -H "Content-Type: application/json" \  -d '{       "fields": {         "given_name": "Olena",         "family_name": "Kovalenko",         "phone1": "+420777123456",         "email": "olena@example.com"       },       "source_code": "web",       "consent": {         "granted": true,         "text_version": "v1",         "evidence": "web form"       }     }'
Ключ у прикладі вигаданий. Ніколи не вставляйте справжній ключ у код, який виконується в браузері.

Документація OpenAPI

Повний опис маршрутів і структур даних є в застосунку у форматі OpenAPI (Swagger). Документація доступна адміністратору агентства після входу.

Документація OpenAPI (відкриється в новому вікні)

Доступна адміністратору агентства після входу. Публічний довідник готуємо.

Інтеграції

Доступно
  • Реєстри компаній ARES (CZ), RPO (SK), Biała Lista (PL)
  • Банківські файли ABO (CZK) і SEPA pain.001 (EUR) для авансів
  • Отримання кандидатів через пересланий електронний лист
  • Імпорт і експорт CSV, JSON (для імпорту також XLSX, ODS, XML)
  • Дзеркалювання співбесід у Google Календар
  • SMS і Telegram для комунікації з кандидатами
Готуємо
  • Імпорт обліку часу через API напряму із систем обліку клієнтів (заводів)
  • інтеграція з Ina.work
  • експорт у зарплатні програми

Згенеруйте API-ключ

Зареєструйте агентство безкоштовно, створіть ключ у налаштуваннях і надішліть перший запит. 30 днів на випробування без платіжної картки, зокрема з доплатою Power.

Зареєструватися й отримати API-ключ