Stafio API
Otwarty interfejs, przez który Twoja strona internetowa, system rekrutacyjny lub rekruter AI łączy się ze Stafio. Jeden adres, jeden format żądania i zawsze tylko dane Twojego konta.
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 }
}Do czego służy API
Co możesz zrobić przez interfejs
Ogłoszenia o pracę na Twojej stronie
Wyświetlaj ogłoszenia ze Stafio na swojej stronie, a odpowiedzi trafią prosto do rekrutacji — bez eksportów i ręcznego zakładania kandydatów.
- Lista i szczegóły ogłoszenia, w tym opis, galeria i wideo
- Odpowiedź na ogłoszenie tworzy kandydata i jego zgłoszenie
- CV jest dołączane do odpowiedzi i ustawiane jako CV kandydata
Kandydaci z zewnętrznego systemu
Kandydatów może zbierać inne narzędzie — system rekrutacyjny, strona kariery albo rekruter AI, który wstępnie weryfikuje kandydatów przez telefon. Zostają przekazani do Stafio, a rekrutacja, wdrożenie, zmiany i ewidencja czasu pracy toczą się dalej w jednym miejscu.
- Rejestracja kandydata także bez konkretnego ogłoszenia
- Notatka ze wstępnej weryfikacji zostaje przy osobie
- Dopasowanie po adresie e-mail; API odrzuca zduplikowane rejestracje
Własna bramka SMS
Jeśli masz własną bramkę SMS albo preferencyjną taryfę u operatora, podłącz ją do Stafio, a wiadomości będą wychodzić przez nią.
- Konfiguracja bramki i przekazywanie wiadomości do wysłania
- Wyniki doręczenia raportowane z powrotem do Stafio
- Wiadomości przychodzące i połączenia na karcie osoby
Dostęp na własnym koncie integracji
Tokenu nie tworzy się ręcznie — API wydaje go w zamian za klucz API. Dostawca integracji nigdy nie potrzebuje hasła konta, na którym ona działa.
- Każda integracja ma własnego użytkownika z rolą API
- Przypisane miejsca pracy i centra kosztów wyznaczają zakres danych
- Klucz API unieważniasz, wyłączając go, bez zmiany hasła użytkownika
Jak działa API
Jeden adres, jeden kształt odpowiedzi
Nie wywołujesz różnych ścieżek dla poszczególnych funkcji — żądanie zawsze trafia do tego samego endpointu, a jego treść określa, co zrobić. Treść ma trzy pola: version (wersja kontraktu), func (logiczna nazwa funkcji) i params. Nagłówek Prefer: params=single-object jest obowiązkowy.
Odpowiedź ma zawsze ten sam kształt, niezależnie od wyniku. Błędy wracają w tej samej kopercie i rozróżnia się je po polu ok i strukturze error — klient obsługuje wszystko jednolicie i nie musi zajmować się różnymi kodami statusu.
{
"ok": true,
"version": 8,
"func": "job.list",
"data": [ { "job_id": 1042, "name": "Pracownik magazynu" } ],
"meta": { "row_count": 1 },
"error": null
}Przegląd funkcji
Co potrafi interfejs
| Funkcja | Do czego służy | Główne parametry |
|---|---|---|
ping | Sprawdzenie dostępności | bez parametrów |
job.list | Lista ogłoszeń o pracę | region_id, work_type_id, partner_id, label_ids, limit, offset |
job.detail | Szczegóły ogłoszenia, w tym opis, galeria i wideo | job_id |
job.response | Odpowiedź na ogłoszenie — tworzy kandydata i jego zgłoszenie | job_id, first_name, last_name, email, mobile, response_text, cv_file_name, cv_base64 |
person.register | Rejestracja kandydata bez powiązania z ogłoszeniem | first_name, last_name, email, mobile, cost_center, emergency_contact, note, cv_file_name, cv_base64 |
department.list | Miejsca pracy przypisane do wywołującego konta | bez parametrów |
cost_center.list | Centra kosztów („Chcę pracować jako”) | department_id |
sms.gateway.* | Własna bramka SMS — konfiguracja, przekazywanie wiadomości, raporty doręczeń, wiadomości przychodzące i połączenia | zależnie od funkcji |
API samo nie wysyła żadnych e-maili. Wiadomość z potwierdzeniem lub powitaniem powstaje tylko wtedy, gdy wywołanie przekaże ID szablonu e-maila — szablonem zarządzasz w swoim koncie.
Powiązane moduły