Přeskočit na obsah
JOBSON, software pro agentury práce
Registrovat

REST API v ceně · MCP s příplatkem Power

API a MCP server JOBSON 3

Pošlete kandidáty z vlastního webu, synchronizujte kartotéku s jiným systémem nebo připojte JOBSON do Claude či ChatGPT.

Registrovat a získat API klíčOpenAPI dokumentace (otevře se v novém okně)

Dokumentace je dostupná po přihlášení správci agentury.

JOBSON 3 má REST API pro nábor a kartotéku osob a MCP server pro AI klienty Claude a ChatGPT.REST API je v ceně, bez příplatku a bez kvóty. Ověřuje se API klíčem agentury, chyby vrací podle RFC 9457. MCP server je součástí příplatku Power. Dokumentace OpenAPI je v aplikaci po přihlášení.

REST API
nábor, kartotéka osob · v ceně · bez kvóty
MCP
Claude, ChatGPT · příplatek Power · 10 000 až 50 000 volání měsíčně
Autentizace
Bearer API klíč agentury s rozsahy
Chyby
RFC 9457 (problem+json)
Dokumentace
OpenAPI v aplikaci pro správce agentury

REST API

Typické použití: formulář na kariérním webu agentury posílá kandidáty rovnou do JOBSONu, nebo se kartotéka pravidelně synchronizuje s jiným systémem.

Nábor

4 endpointy

  • POST/api/recruitment/inbound

    pošle kandidáta do fronty Příchozí (kontrola duplicit, zdroj, souhlas GDPR)

  • GET/api/recruitment/vacancies

    seznam zakázek

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

    uchazeči v zakázce

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

    přijatí kandidáti od data

Kartotéka osob

5 endpointů

  • POST/api/v1/people

    založí nebo aktualizuje osoby (upsert)

  • GET/api/v1/people

    export osob

  • GET/api/v1/people/schema

    schéma polí včetně vlastních polí agentury

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

    jedna osoba podle interního čísla

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

    stav importu

Příplatek Power

MCP server pro Claude a ChatGPT

MCP (Model Context Protocol) je otevřený standard pro připojení AI asistentů k aplikacím. JOBSON má vlastní MCP server, takže ho do Claude nebo ChatGPT připojíte jako konektor a asistent pracuje s daty agentury přes stejné nástroje jako AI asistent v aplikaci.

  • Endpoint

    POST /mcp

  • Token vázaný na člověka

    Vytvoří ho uživatel s oprávněním v aplikaci. Token může práva jen ubrat, nikdy přidat. Platnost 30, 90 nebo 365 dní.

  • Zápis jen s výslovným oprávněním

    Bez něj token data jen čte.

  • Kvóty podle příplatku Power

    10 000 / 20 000 / 50 000 volání nástrojů měsíčně. initialize, ping a tools/list se nepočítají. Od 90 % přijde upozornění, po vyčerpání se volání odmítne.

  • Kredity

    AI operace, které nástroje spustí, se platí kredity jako v aplikaci.

  • Log

    Každé volání je dohledatelné v historii změn.

Autentizace a chyby

REST API používá API klíč agentury v hlavičce Authorization: Bearer. Klíč vytvoří správce v nastavení náboru nebo importu a patří vždy jedné skupině rozsahů. Chyby vrací API ve formátu RFC 9457 s kódem a klíčem zprávy.

bashFiktivní klíč · ukázka
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": "Novák",         "phone1": "+420777123456",         "email": "jan@example.com"       },       "source_code": "web",       "consent": {         "granted": true,         "text_version": "v1",         "evidence": "web form"       }     }'
Klíč v ukázce je vymyšlený. Skutečný klíč nikdy nevkládejte do kódu, který běží v prohlížeči.

Dokumentace OpenAPI

Kompletní popis cest a tvarů dat je v aplikaci jako OpenAPI (Swagger). Dokumentace je dostupná po přihlášení správci agentury.

OpenAPI dokumentace (otevře se v novém okně)

Dostupná po přihlášení správci agentury. Veřejnou referenci připravujeme.

Integrace

Dostupné
  • Registry firem ARES (CZ), RPO (SK), Biała Lista (PL)
  • Bankovní soubory ABO (CZK) a SEPA pain.001 (EUR) pro zálohy
  • Příjem kandidátů přeposlaným e-mailem
  • Import a export CSV, JSON (import i XLSX, ODS, XML)
  • Zrcadlení pohovorů do Google Kalendáře
  • SMS a Telegram pro komunikaci s kandidáty
Připravujeme
  • Import docházky přes API přímo z docházkových systémů zákazníků (továren)
  • propojení s Ina.work
  • exporty do mzdových programů

Vygenerujte si API klíč

Zaregistrujte agenturu zdarma, v nastavení vytvořte klíč a pošlete první požadavek. 30 dní na vyzkoušení bez platební karty, včetně příplatku Power.

Registrovat a získat API klíč