L'évaluation vérifiée dans le système que vous utilisez déjà.
Hirovia est une couche de mesure, pas un outil de plus où se connecter. Quatre façons de le brancher — de la règle de messagerie en deux minutes à l'intégration REST complète avec votre ATS.
Obtenir une clé sandbox — gratuit Lire la référence API
Les candidats sandbox ne sont jamais facturés · sans carte bancaire
Quatre façons de se connecter, par ordre d'effort.
Mettez votre adresse de réception privée en copie des candidatures, ou transférez-les. Hirovia lit l'expéditeur, identifie le poste depuis l'objet, enregistre le CV et invite le candidat. Une règle de transfert Gmail ou Outlook suffit à toute l'intégration.
Idéal pour : les équipes dont les candidatures arrivent déjà par e-mailUne page de candidature en marque blanche au nom de votre entreprise. Liez-la depuis votre page carrières ou intégrez-la dans une iframe. Les candidats postulent et sont évalués d'un seul mouvement.
Idéal pour : les pages carrières sans ATS derrièreCollez une liste de noms et d'e-mails, choisissez le poste, et chaque candidat reçoit un lien unique. Réexportez les résultats notés en CSV.
Idéal pour : les campagnes ponctuelles et les pilotesCréez les candidats depuis votre ATS dès qu'une candidature arrive, interrogez les scores et réécrivez le composite dans votre propre fiche. JSON en entrée, JSON en sortie, authentification par jeton bearer.
Idéal pour : éditeurs d'ATS, RPO et tout système de recrutement interneLes rejets et les plaintes pour spam vous sont remontés automatiquement : une invitation envoyée à une adresse mal saisie apparaît comme un problème plutôt que comme un silence.
Inclus avec toutes les méthodesUne clé sandbox crée de vraies fiches candidat qui ne sont jamais facturées — et permet de simuler une évaluation terminée, pour tester votre logique de notation sans passer un test de 30 minutes.
Gratuit, illimitéCe que l'intégration vous apporte vraiment.
Si vous pilotez le recrutement
- L'évaluation démarre à la seconde où la candidature arrive, pas quand quelqu'un s'en occupe
- Les scores vivent à côté de vos propres fiches candidat — aucun second système à consulter
- Votre ATS trie, filtre et écarte sur une capacité vérifiée plutôt que sur des mots-clés
- Aucune étape de copier-coller à oublier un jour chargé
Si vous éditez des logiciels de recrutement
- Ajoutez une vraie couche d'évaluation sans construire de psychométrie ni recruter un psychologue I/O
- 20 profils de poste étudiés, notation, contrôles de validité et guides d'entretien, prêts à l'emploi
- Marque blanche : vos utilisateurs ne voient jamais notre marque
- Un tarif par évaluation que vous pouvez revendre, dès $0.75 en volume
L'API en six endpoints.
URL de base https://hirovia.com/api/v1. Authentifiez-vous avec un jeton bearer depuis Paramètres → API. Les clés commençant par hv_test_ sont en sandbox ; les hv_live_ sont réelles et comptent dans votre forfait. 120 requêtes par minute et par clé.
| Endpoint | Rôle |
|---|---|
GET /ping | Vérifie que la clé fonctionne et indique dans quel mode vous êtes |
GET /roles | Les 20 identifiants de poste que vous pouvez évaluer |
POST /candidates | Crée un candidat et renvoie son lien d'évaluation unique |
GET /candidates | Liste les candidats, filtrable par statut et par poste |
GET /candidates/{id} | Un candidat avec ses scores ; ajoutez ?include=report pour le rapport complet |
POST /candidates/{id}/simulate | Sandbox uniquement. Simule une évaluation terminée pour tester le traitement des résultats |
Créer un candidat
curl -X POST https://hirovia.com/api/v1/candidates \
-H "Authorization: Bearer hv_test_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Jane Doe",
"email": "jane@example.com",
"role": "cam",
"send_email": true
}'
{
"id": 412,
"name": "Jane Doe",
"role": "cam",
"role_title": "Corporate Accounts Manager",
"status": "invited",
"test": true,
"assessment_url": "https://hirovia.com/a/xJ2f8Kq1",
"invitation_emailed": false
}
Envoyez vous-même le candidat vers assessment_url, ou activez send_email et Hirovia lui écrit au nom de votre entreprise.
Lire le résultat
curl https://hirovia.com/api/v1/candidates/412 \ -H "Authorization: Bearer hv_test_..."
{
"id": 412,
"status": "completed",
"completed_at": "2026-08-19T10:41:00Z",
"scores": {
"composite": 89,
"role_fit": 90,
"band": "Exceptional",
"scenarios_pct": 78,
"validity_flags": []
}
}
composite est le score de classement de 0 à 100. band est la lecture en clair de l'adéquation au poste. Un validity_flags non vide signifie que les réponses ont semblé négligées ou truquées — traitez ce profil avec méfiance quel que soit son score.
Tester toute la boucle sans vrai candidat
curl -X POST https://hirovia.com/api/v1/candidates/412/simulate \
-H "Authorization: Bearer hv_test_..." \
-H "Content-Type: application/json" \
-d '{"band": "weak"}'
Renvoie un candidat terminé complet, structure du rapport comprise, pour construire et tester votre traitement des résultats en quelques minutes. Passez "band": "weak" pour obtenir un profil signalé et mal noté, et vérifier aussi votre chemin d'erreur.
Erreurs
Chaque échec renvoie la même structure, avec un statut HTTP qui veut dire ce qu'il dit.
{ "error": { "message": "unknown role 'manager' - call GET /api/v1/roles for valid ids",
"status": 400 } }
| Statut | Signification |
|---|---|
| 400 | Quelque chose dans votre requête est incorrect ; le message précise quoi |
| 401 | Clé manquante, invalide ou révoquée |
| 402 | Essai gratuit épuisé — ajoutez un moyen de paiement |
| 403 | Endpoint réservé au sandbox appelé avec une clé live |
| 404 | Aucun candidat de ce type dans votre compte |
| 429 | Plus de 120 requêtes en une minute |
Les candidats créés par API se facturent comme tous les autres.
Ce qui compte
- Uniquement les évaluations terminées. Créer un candidat via l'API est gratuit, comme n'importe quelle invitation
- Les candidats créés avec une clé live comptent dans le volume inclus de votre forfait et consomment votre crédit prépayé
- Les tarifs dégressifs s'appliquent automatiquement — jusqu'à $0.75 par évaluation à l'échelle
- Vos cinq premiers candidats sont gratuits, quelle que soit leur origine
Ce qui ne compte jamais
- Les candidats sandbox ne sont jamais facturés et ne consomment jamais votre essai gratuit
- Les évaluations simulées sont gratuites et illimitées
- Les invitations jamais passées ne coûtent rien, jamais
- Les invitations rejetées ou non délivrées ne coûtent rien
Vous pouvez donc construire et tester toute l'intégration sans rien payer, puis changer une seule clé pour passer en production.
Assurez-vous que la personne qui a passé le test est celle que vous recevrez en entretien.
L'IA peut rédiger le CV. Un ami peut passer l'évaluation. Avec la vérification d'identité activée, chaque candidat photographie une pièce d'identité officielle et prend un selfie en direct avant la première question — la note est ainsi rattachée à une personne réelle et vérifiée, et le nom du document est comparé à celui de la candidature.
La vérification a lieu dès le début : impossible de répondre d'abord et de se vérifier ensuite. Sans identité vérifiée, pas d'évaluation.
Stripe Identity lit le document, contrôle ses éléments de sécurité, confirme que le selfie est celui d'une personne réelle et le compare à la photo du document. Compatible avec les passeports, permis de conduire et cartes d'identité de plus de 100 pays.
Le rapport indique vérifié / non vérifié et si le nom du document correspond à la candidature. Hirovia ne conserve jamais d'images de pièces d'identité, de numéros de document ni de dates de naissance — rien de sensible n'entre dans votre compte.
Facturée une seule fois par candidat lors de sa première tentative, quel qu'en soit le résultat ; un candidat qui échoue dispose d'une nouvelle tentative sans frais. Les candidats ne paient jamais rien. La vérification est un signal antifraude pour votre processus, pas une enquête d'antécédents ni un rapport de solvabilité.
Commencez gratuitement, ajoutez la vérification quand vous voulez
Récupérez une clé sandbox et essayez maintenant.
Gratuite, illimitée, et rien n'est facturé tant que vous n'avez pas basculé sur une clé live.