Verifizierte Assessments in dem System, das Sie schon nutzen.
Hirovia ist eine Messebene, kein weiteres Portal zum Einloggen. Vier Wege, es anzuschließen — von einer Mail-Regel in zwei Minuten bis zur vollen REST-Integration in Ihr ATS.
Sandbox-Key holen — gratis API-Referenz lesen
Sandbox-Kandidaten werden nie abgerechnet · keine Karte zum Start
Vier Wege, aufsteigend nach Aufwand.
Bewerbungen an Ihre private Eingangsadresse cc'en oder weiterleiten. Hirovia liest den Absender, erkennt die Position am Betreff, speichert den Lebenslauf und lädt den Bewerber ein. Eine Weiterleitungsregel in Gmail oder Outlook ist die ganze Integration.
Passt für: Teams, deren Bewerbungen ohnehin per E-Mail ankommenEine White-Label-Bewerbungsseite unter dem Namen Ihres Unternehmens. Verlinken Sie sie von Ihrer Karriereseite oder betten Sie sie als iframe ein. Bewerber bewerben sich und werden in einem Durchlauf getestet.
Passt für: Karriereseiten ohne ATS dahinterEine Liste mit Namen und E-Mail-Adressen einfügen, die Position wählen, und jeder Bewerber bekommt einen eigenen Link. Bewertete Ergebnisse holen Sie als CSV wieder heraus.
Passt für: einmalige Kampagnen und PilotprojekteKandidaten aus Ihrem ATS anlegen, sobald eine Bewerbung eingeht, Scores abrufen und den Wert composite in Ihren eigenen Datensatz zurückschreiben. JSON rein, JSON raus, Bearer-Token-Auth.
Passt für: ATS-Anbieter, RPOs und alle mit eigenem Recruiting-SystemBounces und Spam-Beschwerden werden automatisch zurückgemeldet, damit eine Einladung an eine vertippte Adresse als Problem sichtbar wird und nicht als Stille.
In jeder Methode enthaltenEin Sandbox-Key legt echte Kandidatendatensätze an, die nie abgerechnet werden — und lässt Sie ein abgeschlossenes Assessment simulieren, damit Sie Ihre Scoring-Logik testen können, ohne selbst 30 Minuten lang Fragen zu beantworten.
Gratis, unbegrenztWas Ihnen die Integration tatsächlich bringt.
Wenn Sie Recruiting verantworten
- Das Assessment startet in der Sekunde, in der eine Bewerbung eingeht — nicht, wenn jemand dazu kommt
- Scores stehen neben Ihren eigenen Kandidatendaten — kein zweites System zum Nachsehen
- Ihr ATS kann nach geprüfter Eignung sortieren, filtern und absagen statt nach Keyword-Match
- Kein Copy-and-paste-Schritt, den man an einem vollen Tag vergisst
Wenn Sie Recruiting-Software bauen
- Eine echte Assessment-Ebene ergänzen, ohne Psychometrie zu bauen oder einen I/O-Psychologen einzustellen
- 20 recherchierte Rollenprofile, Scoring, Validitätsprüfungen und Interviewleitfäden, sofort einsatzbereit
- White-Label: Ihre Nutzer sehen unsere Marke nie
- Preise je Assessment, die Sie weiterverkaufen können, ab $0.75 bei Volumen
Die API in sechs Endpunkten.
Basis-URL https://hirovia.com/api/v1. Authentifizierung per Bearer-Token aus Einstellungen → API. Keys, die mit hv_test_ beginnen, sind Sandbox; hv_live_ sind echt und zählen auf Ihren Plan. 120 Requests pro Minute je Key.
| Endpunkt | Funktion |
|---|---|
GET /ping | Bestätigt, dass der Key funktioniert, und nennt den aktiven Modus |
GET /roles | Die 20 Positions-IDs, für die Sie testen können |
POST /candidates | Legt einen Kandidaten an und gibt seinen eigenen Assessment-Link zurück |
GET /candidates | Listet Kandidaten, filterbar nach Status und Position |
GET /candidates/{id} | Ein Kandidat mit Scores; ?include=report ergänzt den vollständigen Report |
POST /candidates/{id}/simulate | Nur Sandbox. Simuliert ein abgeschlossenes Assessment, damit Sie die Ergebnisverarbeitung testen können |
Einen Kandidaten anlegen
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
}
Schicken Sie den Kandidaten selbst auf assessment_url oder setzen Sie send_email, dann schreibt Hirovia ihn unter dem Namen Ihres Unternehmens an.
Das Ergebnis lesen
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 ist die Ranking-Zahl von 0–100. band ist die Rollenpassung in Klartext. Ein nicht leeres validity_flags heißt, dass die Antworten nachlässig oder manipuliert wirkten — behandeln Sie dieses Profil unabhängig von seinem Score mit Misstrauen.
Den ganzen Ablauf ohne echten Kandidaten testen
curl -X POST https://hirovia.com/api/v1/candidates/412/simulate \
-H "Authorization: Bearer hv_test_..." \
-H "Content-Type: application/json" \
-d '{"band": "weak"}'
Gibt einen vollständig ausgefüllten, abgeschlossenen Kandidaten zurück, inklusive Report-Struktur, damit Sie Ihre Ergebnisverarbeitung in Minuten bauen und testen können. Mit "band": "weak" bekommen Sie ein markiertes Profil mit niedrigem Score und prüfen auch den Fehlerfall.
Fehler
Jeder Fehlschlag liefert dieselbe Struktur, mit einem HTTP-Status, der bedeutet, was er sagt.
{ "error": { "message": "unknown role 'manager' - call GET /api/v1/roles for valid ids",
"status": 400 } }
| Status | Bedeutung |
|---|---|
| 400 | Etwas an Ihrem Request stimmt nicht; die Meldung sagt, was |
| 401 | Key fehlt, ist ungültig oder wurde widerrufen |
| 402 | Gratis-Testphase aufgebraucht — Zahlungsmittel hinterlegen |
| 403 | Sandbox-Endpunkt mit einem Live-Key aufgerufen |
| 404 | Diesen Kandidaten gibt es in Ihrem Konto nicht |
| 429 | Mehr als 120 Requests in einer Minute |
API-Kandidaten werden genau wie alle anderen abgerechnet.
Was zählt
- Nur abgeschlossene Assessments. Einen Kandidaten über die API anzulegen ist gratis, genau wie jede Einladung
- Kandidaten mit Live-Key zählen auf das inkludierte Volumen Ihres Plans und werden von Ihrem Guthaben abgezogen
- Mengenrabatte greifen automatisch — bis hinunter zu $0.75 je Assessment
- Ihre ersten fünf Kandidaten sind gratis, egal wie sie angelegt wurden
Was nie zählt
- Sandbox-Kandidaten werden nie abgerechnet und verbrauchen nie Ihre Gratis-Testphase
- Simulierte Abschlüsse sind gratis und unbegrenzt
- Einladungen, die nie angenommen werden, kosten nie etwas
- Abgewiesene oder nicht zugestellte Einladungen kosten nichts
So bauen und testen Sie die gesamte Integration zum Nulltarif und tauschen für den Livegang nur einen Key.
Wissen, dass die Person, die den Test gemacht hat, auch die ist, die Sie einladen.
Die KI kann den Lebenslauf schreiben. Ein Freund kann den Test machen. Mit aktivierter Identitätsprüfung fotografiert jeder Bewerber vor der ersten Frage einen amtlichen Ausweis und nimmt ein Live-Selfie auf – so ist der Wert an einen echten, verifizierten Menschen gebunden, und der Name auf dem Ausweis wird mit dem Namen der Bewerbung abgeglichen.
Die Prüfung läuft ganz am Anfang, sodass niemand erst antworten und sich später verifizieren kann. Kein verifizierter Ausweis, kein Test.
Stripe Identity liest das Dokument, prüft seine Sicherheitsmerkmale, bestätigt, dass das Selfie von einer echten Person stammt, und gleicht es mit dem Ausweisfoto ab. Funktioniert mit Reisepässen, Führerscheinen und Personalausweisen aus über 100 Ländern.
Der Bericht zeigt verifiziert / nicht verifiziert und ob der Name auf dem Ausweis zur Bewerbung passt. Hirovia speichert nie Ausweisbilder, Dokumentnummern oder Geburtsdaten – nichts Sensibles landet in Ihrem Konto.
Einmal pro Kandidat beim ersten Prüfversuch berechnet, unabhängig vom Ergebnis; wer scheitert, erhält einen weiteren Versuch ohne Aufpreis. Bewerber zahlen nie etwas. Die Prüfung ist ein Betrugsschutz-Signal für Ihren Prozess, keine Hintergrundprüfung und kein Bonitätsbericht.
Holen Sie sich einen Sandbox-Key und probieren Sie es aus.
Gratis, unbegrenzt, und nichts wird abgerechnet, bis Sie einen Live-Key einsetzen.