REST API

trønso in Ihr System integrieren.

Kandidaten einladen, Tests abrufen, Ergebnisse synchronisieren, direkt aus Ihrem ATS, HRMS oder eigenen Prozessen heraus.

Bearer-Token-Auth7 EndpunkteRate Limiting inklusiveHR-System-Webhook

API-Keys ab Premium-PlanSofort einsatzbereit

7API-Endpunkte
60Req/min
100%DSGVO-konform
trhr_Key-Format

Was Sie steuern können

Alle wichtigen Funktionen per API erreichbar.

Kandidaten programmatisch einladen

Schicken Sie einen einzelnen API-Call, trønso erstellt die Einladung, versendet die E-Mail und gibt Ihnen den Token zurück. Ideal für automatische Nachfolge-Schritte in Ihrem ATS.

POST /api/v1/invitationsGET /api/v1/invitations

Tests abrufen

Alle aktiven Tests Ihrer Firma auflisten und die passende Test-ID für Einladungen automatisch ermitteln.

GET /api/v1/tests
94

Ergebnisse & Antworten

Score, Status, Anti-Cheat-Protokoll und alle Einzelantworten eines Kandidaten direkt abrufen.

GET /api/v1/results/:idGET /api/v1/candidates/:email/results
@

Kandidaten nachschlagen

Alle Test-Versuche eines Kandidaten per E-Mail-Adresse abrufen, für schnelle Suche im eigenen System.

GET /api/v1/candidates/:email

Bearer-Token-Auth

API-Keys im Format trhr_..., einmalig generiert, SHA-256-gesichert, jederzeit widerrufbar.

Ergebnisse synchronisieren

Score, Status und Anti-Cheat, direkt in Ihr System.

Rufen Sie nach Testabschluss die vollständigen Ergebnisse ab: Gesamtpunktzahl, alle Einzelantworten und das Anti-Cheat-Protokoll, strukturiert als JSON, bereit für Ihr HRMS oder Dashboard.

  • Score + Max-Score als numerische Werte
  • Alle Einzelantworten mit Korrektheit
  • Anzahl der Cheat-Events (Tab-Wechsel, Copy-Paste etc.)
GET /api/v1/results/:attemptId

{

"candidate": { "name": "Max Müller" },,

"score": 94,

"max_score": 100,

"status": "completed",

"cheat_events": 0,

"answers": [ ... ]

}

200 OKinkl. Anti-Cheat-Protokoll
POST /api/v1/hr/webhook?api_key=trhr_...&test_id=uuid

# Ihr HR-System sendet beim Bewerber-Trigger:

{

"first_name": "Anna",

"last_name": "Schmidt",

"email": "[email protected]"

}

// trønso erstellt Einladung + sendet E-Mail automatisch

Einladung versendetkein Duplikat bei aktiver Einladung

HR-System-Integration

ab Premium-Plan

Neuer Bewerber in Ihrem HR-System: Test-Einladung geht automatisch raus.

Richten Sie den Webhook einmalig ein. Danach schickt Ihr HR-System bei jedem neuen Kandidaten einen Trigger, trønso übernimmt den Rest: Einladung erstellen, E-Mail versenden, Duplikate abfangen.

  • Webhook-URL mit API-Key und Test-ID konfigurieren
  • Unterstützt verschiedene HR-System-Payload-Formate
  • Optional: HMAC-Signaturprüfung aktivierbar

In 3 Schritten

API einrichten und loslegen.

01

API-Key generieren

In den Einstellungen unter „API-Keys" einen neuen Schlüssel erstellen. Der Plaintext-Key wird einmalig angezeigt, sicher verwahren.

02

Ersten Request senden

Bearer-Token im Authorization-Header mitsenden. Mit GET /api/v1/tests können Sie sofort alle aktiven Tests Ihrer Firma abrufen.

03

In Ihr System einbinden

Kandidaten per POST einladen, Ergebnisse per GET abrufen oder den HR-System-Webhook einrichten für vollständige Automatisierung.

Anwendungsfälle

Was Teams mit der API aufbauen.

ATS-Automatisierung

Kandidat wird im ATS angelegt → Webhook triggert Einladung → Ergebnis landet automatisch zurück im ATS-Profil. Kein manueller Schritt.

HR-System-Integration

Einmalige Webhook-Konfiguration in Ihrem HR-System. Danach läuft der Prozess vollständig automatisch, von der Bewerbung bis zum Testergebnis.

Eigenes Reporting

Alle Testergebnisse periodisch per API abrufen und in das eigene BI-Tool oder HR-Dashboard importieren, strukturierte JSON-Daten machen es einfach.

REST API ab Premium-Plan

Bereit zur Integration?

API-Dokumentation lesen, Account anlegen, ersten Request in Minuten senden.

Bearer-Token-Auth DSGVO-konform Serverstandort DE 🇩🇪 Rate Limiting inklusive