Przejdź do treści
JOBSON, program dla agencji pracy tymczasowej
Zarejestruj się

REST API w cenie · MCP z opcją Power

API i serwer MCP JOBSON 3

Kandydaci z własnej strony internetowej trafiają prosto do systemu, Kartotekę osób można synchronizować z innym systemem, a JOBSON da się podłączyć do Claude lub ChatGPT.

Zarejestruj się i odbierz klucz APIDokumentacja OpenAPI (otwiera się w nowym oknie)

Dokumentację widzi administrator agencji po zalogowaniu.

JOBSON 3 udostępnia REST API do rekrutacji i Kartoteki osób oraz serwer MCP dla klientów AI Claude i ChatGPT.REST API jest w cenie, bez dopłat i bez limitu. Uwierzytelnianie odbywa się kluczem API agencji, a błędy są zwracane w formacie RFC 9457. Serwer MCP jest częścią opcji Power. Dokumentacja OpenAPI jest w aplikacji po zalogowaniu.

REST API
rekrutacja, Kartoteka osób · w cenie · bez limitu
MCP
Claude, ChatGPT · opcja Power · od 10 000 do 50 000 wywołań miesięcznie
Uwierzytelnianie
klucz API agencji (Bearer) z zakresami uprawnień
Błędy
RFC 9457 (problem+json)
Dokumentacja
OpenAPI w aplikacji dla administratora agencji

REST API

Typowe zastosowanie: formularz na stronie z ofertami pracy agencji wysyła kandydatów bezpośrednio do JOBSONa albo Kartoteka osób jest regularnie synchronizowana z innym systemem.

Rekrutacja

4 endpointy

  • POST/api/recruitment/inbound

    wysyła kandydata do kolejki Przychodzące (kontrola duplikatów, źródło, zgoda RODO)

  • GET/api/recruitment/vacancies

    lista zleceń rekrutacyjnych

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

    kandydaci w zleceniach

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

    przyjęci kandydaci

Kartoteka osób

5 endpointów

  • POST/api/v1/people

    zakłada lub aktualizuje osoby (upsert)

  • GET/api/v1/people

    eksport osób

  • GET/api/v1/people/schema

    schemat pól, łącznie z własnymi polami agencji

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

    jedna osoba według numeru wewnętrznego

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

    status importu

Opcja Power

Serwer MCP dla Claude i ChatGPT

MCP (Model Context Protocol) to otwarty standard łączenia asystentów AI z aplikacjami. Serwer MCP to gniazdko, przez które asystent AI łączy się z JOBSONem. Wystarczy dodać JOBSON w Claude lub ChatGPT jako konektor, a asystent pracuje z danymi agencji za pomocą tych samych narzędzi co asystent AI w aplikacji.

  • Endpoint

    POST /mcp

  • Token przypisany do konkretnej osoby

    Tworzy go użytkownik z odpowiednim uprawnieniem w aplikacji. Token może uprawnienia tylko ograniczyć, nigdy rozszerzyć. Ważność: 30, 90 lub 365 dni.

  • Zapis tylko za wyraźnym uprawnieniem

    Bez niego token wyłącznie odczytuje dane.

  • Limity opcji Power

    10 000 / 20 000 / 50 000 wywołań narzędzi miesięcznie. initialize, ping i tools/list nie są liczone. Od 90 % limitu przychodzi powiadomienie, po jego wyczerpaniu wywołania są odrzucane.

  • Kredyty

    operacje AI uruchamiane przez narzędzia rozlicza się kredytami AI, tak jak w aplikacji.

  • Log

    Każde wywołanie można odnaleźć w historii zmian.

Uwierzytelnianie i błędy

REST API korzysta z klucza API agencji w nagłówku Authorization: Bearer. Klucz tworzy administrator w ustawieniach rekrutacji lub importu i zawsze należy on do jednej grupy zakresów. Błędy API zwraca w formacie RFC 9457, z kodem i kluczem komunikatu.

bashFikcyjny klucz · przykład
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": "Jan",         "family_name": "Kowalski",         "phone1": "+48601234567",         "email": "jan@example.com"       },       "source_code": "web",       "consent": {         "granted": true,         "text_version": "v1",         "evidence": "web form"       }     }'
Klucz w przykładzie jest zmyślony. Prawdziwego klucza nigdy nie należy umieszczać w kodzie uruchamianym w przeglądarce.

Dokumentacja OpenAPI

Pełny opis ścieżek i struktur danych jest dostępny w aplikacji jako OpenAPI (Swagger). Dokumentację widzi administrator agencji po zalogowaniu.

Dokumentacja OpenAPI (otwiera się w nowym oknie)

Dostępna po zalogowaniu dla administratora agencji. Publiczna dokumentacja jest w przygotowaniu.

Integracje

Dostępne
  • Rejestry firm ARES (CZ), RPO (SK), Biała Lista (PL)
  • Pliki bankowe ABO (CZK) i SEPA pain.001 (EUR) do zaliczek
  • Przyjmowanie kandydatów z przekazanych e-maili
  • Import i eksport CSV, JSON (import także XLSX, ODS, XML)
  • Kopiowanie rozmów rekrutacyjnych do Kalendarza Google
  • SMS i Telegram do komunikacji z kandydatami
W przygotowaniu
  • Import ewidencji czasu pracy przez API bezpośrednio z systemów rejestracji czasu pracy klientów (zakładów)
  • połączenie z Ina.work
  • eksporty do programów płacowych

Jak uzyskać klucz API

Wystarczy bezpłatnie zarejestrować agencję, utworzyć klucz w ustawieniach i wysłać pierwsze zapytanie. 30 dni na test bez karty płatniczej, łącznie z opcją Power.

Zarejestruj się i odbierz klucz API