Preskočiť na obsah
JOBSON, softvér pre agentúry dočasného zamestnávania
Registrovať

REST API v cene · MCP s príplatkom Power

API a MCP server JOBSON 3

Pošlite kandidátov z vlastného webu, synchronizujte kartotéku s iným systémom alebo pripojte JOBSON do Claude či ChatGPT.

Registrovať sa a získať API kľúčOpenAPI dokumentácia (otvorí sa v novom okne)

Dokumentácia je dostupná po prihlásení správcovi agentúry.

JOBSON 3 má REST API pre nábor a kartotéku osôb a MCP server pre AI klientov Claude a ChatGPT.REST API je v cene bez príplatku a bez kvóty. Overuje sa API kľúčom agentúry, chyby vracia podľa RFC 9457. MCP server je súčasťou príplatku Power. Dokumentácia OpenAPI je v aplikácii po prihlásení.

REST API
nábor, kartotéka osôb · v cene · bez kvóty
MCP
Claude, ChatGPT · príplatok Power · 10 000 až 50 000 volaní mesačne
Autentifikácia
Bearer API kľúč agentúry s rozsahmi
Chyby
RFC 9457 (problem+json)
Dokumentácia
OpenAPI v aplikácii pre správcu agentúry

REST API

Typické použitie: formulár na kariérnom webe agentúry posiela kandidátov rovno do JOBSONu, alebo sa kartotéka pravidelne synchronizuje s iným systémom.

Nábor

4 endpointy

  • POST/api/recruitment/inbound

    pošle kandidáta do frontu Prichádzajúci (kontrola duplicít, zdroj, súhlas GDPR)

  • GET/api/recruitment/vacancies

    zoznam zákaziek

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

    uchádzači v zákazkách

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

    prijatí kandidáti

Kartotéka osôb

5 endpointov

  • POST/api/v1/people

    založí alebo aktualizuje osoby (upsert)

  • GET/api/v1/people

    export osôb

  • GET/api/v1/people/schema

    schéma polí vrátane vlastných polí agentúry

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

    jedna osoba podľa interného čísla

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

    stav importu

Príplatok Power

MCP server pre Claude a ChatGPT

MCP (Model Context Protocol) je otvorený štandard na pripojenie AI asistentov k aplikáciám. JOBSON má vlastný MCP server, takže ho do Claude alebo ChatGPT pripojíte ako konektor a asistent pracuje s dátami agentúry cez rovnaké nástroje ako AI asistent v aplikácii.

  • Endpoint

    POST /mcp

  • Token viazaný na človeka

    Vytvorí ho používateľ s oprávnením v aplikácii. Token môže práva len ubrať, nikdy pridať. Platnosť 30, 90 alebo 365 dní.

  • Zápis len s výslovným oprávnením

    Bez neho token dáta len číta.

  • Kvóty podľa príplatku Power

    10 000 / 20 000 / 50 000 volaní nástrojov mesačne. initialize, ping a tools/list sa nepočítajú. Od 90 % príde upozornenie, po vyčerpaní sa volanie odmietne.

  • Kredity

    AI operácie, ktoré nástroje spustia, sa platia kreditmi ako v aplikácii.

  • Log

    Každé volanie je dohľadateľné v histórii zmien.

Autentifikácia a chyby

REST API používa API kľúč agentúry v hlavičke Authorization: Bearer. Kľúč vytvorí správca v nastaveniach náboru alebo importu a patrí vždy jednej skupine rozsahov. Chyby vracia API vo formáte RFC 9457 s kódom a kľúčom správy.

bashFiktívny kľúč · ukážka
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": "Ján",         "family_name": "Kováč",         "phone1": "+421905123456",         "email": "jan@example.com"       },       "source_code": "web",       "consent": {         "granted": true,         "text_version": "v1",         "evidence": "web form"       }     }'
Kľúč v ukážke je vymyslený. Skutočný kľúč nikdy nevkladajte do kódu, ktorý beží v prehliadači.

Dokumentácia OpenAPI

Kompletný popis ciest a tvarov dát je v aplikácii ako OpenAPI (Swagger). Dokumentácia je dostupná po prihlásení správcovi agentúry.

OpenAPI dokumentácia (otvorí sa v novom okne)

Dostupná po prihlásení správcovi agentúry. Verejnú referenciu pripravujeme.

Integrácie

Dostupné
  • Registre firiem RPO (SK), ARES (CZ), Biała Lista (PL)
  • Bankové súbory SEPA pain.001 (EUR) a ABO (CZK) pre zálohy
  • Príjem kandidátov preposlaným e-mailom
  • Import a export CSV, JSON (import aj XLSX, ODS, XML)
  • Zrkadlenie pohovorov do Google Kalendára
  • SMS a Telegram na komunikáciu s kandidátmi
Pripravujeme
  • Import dochádzky cez API priamo z dochádzkových systémov zákazníkov (tovární)
  • prepojenie s Ina.work
  • exporty do mzdových programov

Vygenerujte si API kľúč

Zaregistrujte agentúru zadarmo, v nastaveniach vytvorte kľúč a pošlite prvú požiadavku. 30 dní na vyskúšanie bez platobnej karty, vrátane príplatku Power.

Registrovať sa a získať API kľúč