API Stafio
Otevřené rozhraní, přes které se ke Stafiu připojí váš web, náborový systém nebo AI náborář. Jedna adresa, jeden formát požadavku a data vždy jen vašeho účtu.
POST https://<instance>/api/rpc/call
Content-Type: application/json
Content-Profile: api
Prefer: params=single-object
Authorization: Bearer <token>
{
"version": 8,
"func": "job.list",
"params": { "limit": 20, "offset": 0 }
}K čemu API slouží
Co přes rozhraní vyřešíte
Inzeráty na vlastním webu
Inzeráty ze Stafia zobrazíte na svých stránkách a reakce z nich padají rovnou do náboru — bez exportů a ručního zakládání.
- Seznam i detail inzerátu včetně popisu, galerie a videa
- Reakce na inzerát založí uchazeče i jeho odpověď
- Životopis se přiloží k odpovědi a nastaví se jako CV
Kandidáti z externího systému
Kandidáty může sbírat jiný nástroj — náborový systém, kariérní web nebo AI náborář, který uchazeče předvybere po telefonu. Do Stafia se předají k dalšímu zpracování a nábor, nástup, směny i mzdy pak běží na jednom místě.
- Registrace uchazeče i bez vazby na konkrétní inzerát
- Poznámka z předvýběru zůstane u osoby
- Párování podle e-mailu, duplicitu registrace API odmítne
Vlastní SMS brána
Když máte vlastní SMS bránu nebo zvýhodněný tarif u operátora, napojíte ji na Stafio a zprávy odcházejí přes ni.
- Konfigurace brány a výdej zpráv k odeslání
- Hlášení výsledků doručení zpět do Stafia
- Příchozí zprávy i hovory u karty osoby
Přístup pod vlastním účtem integrace
Token se nevytváří ručně — vydává ho samo API proti API klíči. Dodavatel integrace tak nepotřebuje heslo k účtu, pod kterým poběží.
- Každá integrace má vlastního uživatele s rolí pro API
- Rozsah dat řídí přiřazená pracoviště a střediska
- API klíč se odvolá zakázáním, bez zásahu do hesla uživatele
Jak API funguje
Jedna adresa, jeden tvar odpovědi
Nevolají se různé cesty podle funkce — požadavek míří vždy na stejný endpoint a v těle
se řekne, co se má provést. Tělo má tři pole: version (verze kontraktu),
func (logické jméno funkce) a params. Hlavička
Prefer: params=single-object je povinná.
Odpověď má vždy stejný tvar, ať dopadne jakkoli. Chyby se vracejí ve stejné obálce
a rozlišují se polem ok a strukturou error — klient tak má
jednotné zpracování a neřeší různé stavové kódy.
{
"ok": true,
"version": 8,
"func": "job.list",
"data": [ { "job_id": 1042, "name": "Skladník" } ],
"meta": { "row_count": 1 },
"error": null
}Přehled funkcí
Co rozhraní umí
| Funkce | K čemu je | Hlavní parametry |
|---|---|---|
ping | Ověření dostupnosti | bez parametrů |
job.list | Seznam inzerátů | region_id, work_type_id, partner_id, label_ids, limit, offset |
job.detail | Detail inzerátu včetně popisu, galerie a videa | job_id |
job.response | Reakce na inzerát — založí uchazeče i jeho odpověď | job_id, first_name, last_name, email, mobile, response_text, cv_file_name, cv_base64 |
person.register | Registrace uchazeče bez vazby na inzerát | first_name, last_name, email, mobile, cost_center, emergency_contact, note, cv_file_name, cv_base64 |
department.list | Pracoviště přiřazená volajícímu účtu | bez parametrů |
cost_center.list | Střediska („chci pracovat jako“) | department_id |
sms.gateway.* | Vlastní SMS brána — konfigurace, výdej zpráv, hlášení výsledků, příchozí zprávy a hovory | dle jednotlivých funkcí |
API samo od sebe žádný e-mail neodesílá. Potvrzovací nebo uvítací zpráva vznikne jen tehdy, když volání předá ID mailové šablony — šablonu si spravujete ve svém účtu.
Související