API di Stafio
Un’interfaccia aperta attraverso cui il tuo sito web, il tuo sistema di selezione o il tuo recruiter AI si collegano a Stafio. Un solo indirizzo, un solo formato di richiesta e sempre e solo i dati del tuo account.
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 }
}A cosa serve l’API
Cosa puoi fare tramite l’interfaccia
Annunci di lavoro sul tuo sito web
Mostra sul tuo sito gli annunci di lavoro di Stafio: le candidature finiscono direttamente nella selezione — senza esportazioni e senza creare candidati a mano.
- Elenco e dettaglio di un annuncio, con descrizione, galleria e video
- Una candidatura a un annuncio crea il candidato e la sua risposta
- Il CV viene allegato alla candidatura e impostato come CV
Candidati da un sistema esterno
I candidati possono essere raccolti da un altro strumento —un sistema di selezione, un sito carriere o un recruiter AI che fa una preselezione telefonica. Vengono passati a Stafio, dove selezione, onboarding, turni e presenze proseguono in un unico posto.
- Registrazione del candidato anche senza un annuncio specifico
- La nota di preselezione resta con la persona
- Abbinamento tramite email; l’API rifiuta le registrazioni duplicate
Il tuo gateway SMS
Se hai un tuo gateway SMS o una tariffa agevolata con un operatore, collegalo a Stafio e i messaggi partiranno attraverso di esso.
- Configurazione del gateway e consegna dei messaggi da inviare
- Esiti della consegna riportati a Stafio
- Messaggi e chiamate in arrivo nella scheda della persona
Accesso con un account dedicato all’integrazione
Il token non si crea a mano — l’API lo rilascia a fronte di una chiave API. Il fornitore dell’integrazione non ha mai bisogno della password dell’account con cui opera.
- Ogni integrazione ha un proprio utente con un ruolo API
- Sedi e centri di costo assegnati definiscono l’ambito dei dati
- Una chiave API si revoca disattivandola, senza toccare la password dell’utente
Come funziona l’API
Un solo indirizzo, una sola forma di risposta
Non chiami percorsi diversi per ogni funzione — la richiesta va sempre allo stesso endpoint ed è il corpo a dire cosa fare. Il corpo ha tre campi: version (versione del contratto API), func (nome logico della funzione) e params. L’intestazione Prefer: params=single-object è obbligatoria.
La risposta ha sempre la stessa forma, qualunque sia l’esito. Anche gli errori arrivano nello stesso involucro e si distinguono dal campo ok e dalla struttura error — il client ha una gestione uniforme e non deve occuparsi di codici di stato diversi.
{
"ok": true,
"version": 8,
"func": "job.list",
"data": [ { "job_id": 1042, "name": "Magazziniere" } ],
"meta": { "row_count": 1 },
"error": null
}Panoramica delle funzioni
Cosa sa fare l’interfaccia
| Funzione | A cosa serve | Parametri principali |
|---|---|---|
ping | Verifica della disponibilità | nessun parametro |
job.list | Elenco degli annunci di lavoro | region_id, work_type_id, partner_id, label_ids, limit, offset |
job.detail | Dettaglio dell’annuncio, con descrizione, galleria e video | job_id |
job.response | Candidatura a un annuncio — crea il candidato e la sua risposta | job_id, first_name, last_name, email, mobile, response_text, cv_file_name, cv_base64 |
person.register | Registrazione del candidato senza collegamento a un annuncio | first_name, last_name, email, mobile, cost_center, emergency_contact, note, cv_file_name, cv_base64 |
department.list | Sedi assegnate all’account chiamante | nessun parametro |
cost_center.list | Centri di costo («Voglio lavorare come») | department_id |
sms.gateway.* | Il tuo gateway SMS — configurazione, consegna dei messaggi, rapporti di consegna, messaggi e chiamate in arrivo | dipende dalla funzione |
L’API non invia email di propria iniziativa. Un messaggio di conferma o di benvenuto viene creato solo se la chiamata passa l’ID di un modello email — il modello lo gestisci nel tuo account.
Moduli correlati
Si abbina bene a
Recruiting e CRM
I candidati arrivati dall’API proseguono nel consueto processo di selezione.
Scopri di più →