Stafio API
Otvorené rozhranie, cez ktoré sa so Stafio prepojí váš web, náborový systém alebo AI náborár. Jedna adresa, jeden formát požiadavky a vždy len údaje vášho úč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 }
}Na čo slúži API
Čo môžete cez rozhranie robiť
Inzeráty na vlastnom webe
Zobrazte inzeráty zo Stafio na svojom webe a reakcie pôjdu rovno do náboru — bez exportov a bez ručného zakladania uchádzačov.
- Zoznam a detail inzerátu vrátane popisu, galérie a videa
- Reakcia na inzerát založí uchádzača aj jeho reakciu
- Životopis sa priloží k reakcii a nastaví sa ako CV uchádzača
Uchádzači z externého systému
Uchádzačov môže zbierať iný nástroj — náborový systém, kariérny web alebo AI náborár, ktorý záujemcov predbežne preverí telefonicky. Odovzdajú sa do Stafio a nábor, nástup, zmeny aj dochádzka potom bežia na jednom mieste.
- Registrácia uchádzača aj bez konkrétneho inzerátu
- Poznámka z predvýberu zostáva pri osobe
- Párovanie podľa e-mailu; API odmietne duplicitné registrácie
Vlastná SMS brána
Ak máte vlastnú SMS bránu alebo zvýhodnený tarif u operátora, pripojte ju k Stafio a správy budú odchádzať cez ňu.
- Konfigurácia brány a vydávanie správ na odoslanie
- Výsledky doručenia hlásené späť do Stafio
- Prichádzajúce správy a hovory na karte osoby
Prístup pod vlastným účtom integrácie
Token sa nevytvára ručne — API ho vydá na základe API kľúča. Dodávateľ integrácie nikdy nepotrebuje heslo účtu, pod ktorým integrácia beží.
- Každá integrácia má vlastného používateľa s rolou API
- Rozsah údajov určujú priradené pracoviská a strediská
- API kľúč zrušíte jeho deaktiváciou, bez zásahu do hesla používateľa
Ako API funguje
Jedna adresa, jeden tvar odpovede
Pre jednotlivé funkcie nevoláte rôzne cesty — požiadavka ide vždy na rovnaký endpoint a telo hovorí, čo sa má urobiť. Telo má tri polia: version (verzia kontraktu), func (logický názov funkcie) a params. Hlavička Prefer: params=single-object je povinná.
Odpoveď má vždy rovnaký tvar, nech je výsledok akýkoľvek. Chyby sa vracajú v rovnakej obálke a rozlišujú sa podľa poľa ok a štruktúry error — klient má jednotné spracovanie a nerieši rôzne stavové kódy.
{
"ok": true,
"version": 8,
"func": "job.list",
"data": [ { "job_id": 1042, "name": "Skladník" } ],
"meta": { "row_count": 1 },
"error": null
}Prehľad funkcií
Čo rozhranie dokáže
| Funkcia | Na čo slúži | Hlavné parametre |
|---|---|---|
ping | Kontrola dostupnosti | bez parametrov |
job.list | Zoznam inzerátov | region_id, work_type_id, partner_id, label_ids, limit, offset |
job.detail | Detail inzerátu vrátane popisu, galérie a videa | job_id |
job.response | Reakcia na inzerát — založí uchádzača a jeho reakciu | job_id, first_name, last_name, email, mobile, response_text, cv_file_name, cv_base64 |
person.register | Registrácia uchádzača bez väzby na inzerát | first_name, last_name, email, mobile, cost_center, emergency_contact, note, cv_file_name, cv_base64 |
department.list | Pracoviská priradené volajúcemu účtu | bez parametrov |
cost_center.list | Strediská („Chcem pracovať ako“) | department_id |
sms.gateway.* | Vlastná SMS brána — konfigurácia, vydávanie správ, doručenky, prichádzajúce správy a hovory | podľa funkcie |
API samo neposiela žiadne e-maily. Potvrdzujúca alebo uvítacia správa vznikne, len keď volanie odovzdá ID e-mailovej šablóny — šablónu spravujete vo svojom účte.
Súvisiace moduly