API Stafio
Une interface ouverte par laquelle votre site web, votre système de recrutement ou votre recruteur IA se connecte à Stafio. Une seule adresse, un seul format de requête et toujours uniquement les données de votre compte.
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 }
}À quoi sert l’API
Ce que vous pouvez faire via l’interface
Des annonces sur votre propre site web
Affichez les annonces de Stafio sur votre site web : les candidatures arrivent directement dans le recrutement — sans export et sans création manuelle des candidats.
- Liste et détail d’une annonce, avec description, galerie et vidéo
- Une réponse à une annonce crée le candidat et sa candidature
- Le CV est joint à la candidature et enregistré comme CV
Des candidats depuis un système externe
Un autre outil peut collecter les candidats — un système de recrutement, un site carrière ou un recruteur IA qui présélectionne les candidats par téléphone. Ils sont transmis à Stafio, et le recrutement, l’intégration, les créneaux et les présences se déroulent ensuite au même endroit.
- Inscription de candidats même sans annonce précise
- La note de présélection reste sur la fiche de la personne
- Rapprochement par e-mail ; l’API refuse les inscriptions en double
Votre propre passerelle SMS
Si vous avez votre propre passerelle SMS ou un tarif avantageux chez un opérateur, connectez-la à Stafio : les messages partiront par son intermédiaire.
- Configuration de la passerelle et transmission des messages à envoyer
- Résultats de remise renvoyés à Stafio
- Messages et appels entrants sur la fiche de la personne
Un accès sous le compte propre à l’intégration
Le jeton n’est pas créé à la main — l’API le délivre en échange d’une clé API. Le fournisseur de l’intégration n’a jamais besoin du mot de passe du compte sous lequel elle tourne.
- Chaque intégration a son propre utilisateur avec un rôle API
- Les lieux de travail et centres de coûts attribués définissent le périmètre des données
- Une clé API se révoque en la désactivant, sans toucher au mot de passe de l’utilisateur
Comment fonctionne l’API
Une seule adresse, une seule forme de réponse
Vous n’appelez pas des chemins différents selon la fonction — une requête part toujours vers le même endpoint et c’est le corps qui indique quoi faire. Le corps comporte trois champs : version (version du contrat), func (nom logique de la fonction) et params. L’en-tête Prefer: params=single-object est obligatoire.
La réponse a toujours la même forme, quel que soit le résultat. Les erreurs reviennent dans la même enveloppe et se distinguent par le champ ok et la structure error — le client bénéficie d’un traitement uniforme et n’a pas à gérer différents codes de statut.
{
"ok": true,
"version": 8,
"func": "job.list",
"data": [ { "job_id": 1042, "name": "Magasinier" } ],
"meta": { "row_count": 1 },
"error": null
}Aperçu des fonctions
Ce que l’interface sait faire
| Fonction | À quoi elle sert | Paramètres principaux |
|---|---|---|
ping | Vérification de la disponibilité | aucun paramètre |
job.list | Liste des annonces | region_id, work_type_id, partner_id, label_ids, limit, offset |
job.detail | Détail d’une annonce, avec description, galerie et vidéo | job_id |
job.response | Réponse à une annonce — crée le candidat et sa candidature | job_id, first_name, last_name, email, mobile, response_text, cv_file_name, cv_base64 |
person.register | Inscription d’un candidat sans lien avec une annonce | first_name, last_name, email, mobile, cost_center, emergency_contact, note, cv_file_name, cv_base64 |
department.list | Lieux de travail attribués au compte appelant | aucun paramètre |
cost_center.list | Centres de coûts (« Je veux travailler comme ») | department_id |
sms.gateway.* | Votre propre passerelle SMS — configuration, transmission des messages, accusés de réception, messages et appels entrants | selon la fonction |
L’API n’envoie aucun e-mail d’elle-même. Un message de confirmation ou de bienvenue n’est créé que si l’appel transmet l’ID d’un modèle d’e-mail — vous gérez ce modèle dans votre compte.
Modules associés
À combiner avec
Solutions RH sur mesure
Un portail ou une application construits sur cette interface.
En savoir plus →Recrutement et CRM
Les candidats issus de l’API suivent le processus de recrutement habituel.
En savoir plus →Communication
Des messages via votre propre passerelle SMS, à côté du chat et de l’e-mail.
En savoir plus →