API für Entwickler

Integrieren Sie wissenschaftlich fundierte Potenzialanalysen direkt in Ihre HR-Software, ATS-Systeme oder eigene Anwendungen.

# Kandidat zur Potenzialanalyse einladen
curl -X POST https://www.potenzial.at/api/v1/invites \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"email":"kandidat@firma.at"}'

In 3 Schritten starten

Von der Registrierung bis zur ersten Analyse

1

API-Key erstellen

Registrieren Sie sich kostenlos und erhalten Sie sofort Ihren API-Key.

Jetzt registrieren
2

Credits kaufen

Laden Sie Guthaben auf - pay-as-you-go oder mit Mengenrabatt.

Preise ansehen
3

Integrieren

Laden Sie Kandidaten ein und rufen Sie Ergebnisse per API ab.

Endpoints ansehen

Code-Beispiele

Einfache Integration in jede Programmiersprache

# Kandidat einladen
curl -X POST https://www.potenzial.at/api/v1/invites \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "kandidat@beispiel.at",
    "product_type": "pa-fuehrung",
    "callback_url": "https://ihre-app.at/webhook"
  }'

# Ergebnis abrufen
curl https://www.potenzial.at/api/v1/results/inv_xxx \
  -H "Authorization: Bearer pk_live_xxx"
import requests

API_KEY = "pk_live_xxx"
BASE_URL = "https://www.potenzial.at/api/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Kandidat einladen
response = requests.post(
    f"{BASE_URL}/invites",
    headers=headers,
    json={
        "email": "kandidat@beispiel.at",
        "product_type": "pa-fuehrung"
    }
)

invite = response.json()
print(f"Einladung erstellt: {invite['invite_id']}")
const API_KEY = 'pk_live_xxx';
const BASE_URL = 'https://www.potenzial.at/api/v1';

// Kandidat einladen
const response = await fetch(`${BASE_URL}/invites`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'kandidat@beispiel.at',
    product_type: 'pa-fuehrung'
  })
});

const invite = await response.json();
console.log(`Einladung erstellt: ${invite.invite_id}`);
<?php
$api_key = 'pk_live_xxx';
$base_url = 'https://www.potenzial.at/api/v1';

// Kandidat einladen
$ch = curl_init("$base_url/invites");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $api_key",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'email' => 'kandidat@beispiel.at',
        'product_type' => 'pa-fuehrung'
    ])
]);

$response = curl_exec($ch);
$invite = json_decode($response, true);
echo "Einladung erstellt: " . $invite['invite_id'];

API Endpoints

RESTful API mit JSON-Responses

Öffentliche Endpoints

POST /register

API-Key erstellen

Registrierung als neuer API-Kunde mit E-Mail und Firmenname.

GET /products

Produkte abrufen

Liste aller verfügbaren Analyse-Typen und Pakete.

GET /health

API Status

Systemstatus und Verfügbarkeit prüfen.

Authentifizierte Endpoints

GET /balance

Guthaben prüfen

Aktuelles Guthaben und Verbrauch anzeigen.

GET /search

Analysen suchen

Kandidaten nach Name, E-Mail oder Datum finden.

POST /invites

Kandidat einladen

Einladung zur Potenzialanalyse versenden.

GET /invites

Einladungen auflisten

Alle Einladungen mit Status anzeigen.

GET /invites/{id}/results

Ergebnisse (JSON)

Alle Dimensionen als strukturierte JSON-Daten.

GET /invites/{id}/report

PDF-Report

PDF herunterladen (Standard, Führung, Sales).

GET /invites/{id}/match

Matching

Kandidat mit Job-Profil vergleichen.

POST /job-profiles

Job-Profile erstellen

Idealprofil mit Dimensionen anlegen.

POST /invites/{id}/remind

Erinnerung senden

Reminder-E-Mail an Kandidaten (max. 3x).

POST /webhooks

Webhook einrichten

Benachrichtigungen bei Analyse-Abschluss.

GET /invoices

Rechnungen abrufen

Liste aller Rechnungen mit PDF-Download.

GET /gdpr/candidates

DSGVO-Kandidaten

Liste der löschbaren Kandidaten.

DELETE /gdpr/candidates/{id}

DSGVO-Löschung

Kandidatendaten anonymisieren (DSGVO).

Teams Neu

GET /teams

Teams auflisten

Alle Teams Ihres Accounts abrufen.

POST /teams

Team erstellen

Neues Team für Gruppenanalysen anlegen.

GET /teams/{id}

Team-Details

Team-Info mit Mitgliederliste abrufen.

POST /teams/{id}/members

Mitglieder hinzufügen

Kandidaten einem Team zuordnen.

DELETE /teams/{id}/members/{sid}

Mitglied entfernen

Kandidaten aus Team entfernen.

GET /teams/{id}/export

Team exportieren

Team-Daten als CSV oder JSON exportieren.

Profile Neu

GET /profiles

Alle Profile auflisten

ALLE abgeschlossenen Assessments (API + Admin Tool).

GET /profiles/{session_id}

Profil-Details

Vollständige Ergebnisse und Team-Zuordnungen.

API-Key erstellen

Kostenlos registrieren und sofort starten

Kontaktdaten
Rechnungsadresse
Registrierung erfolgreich!
Speichern Sie diesen Key jetzt! Er wird nur einmal angezeigt.

Admin-Zugang

Hier können Sie Kandidaten auch manuell einladen und Ergebnisse einsehen - ohne API-Aufrufe.

Wichtig: Bitte ändern Sie das Passwort nach dem ersten Login unter "Account".

Credits kaufen

Credits können Sie bequem im Admin-Tool kaufen. Die Zugangsdaten haben Sie nach der Registrierung per E-Mail erhalten.


So funktioniert's:
  1. Melden Sie sich im Admin-Tool mit Ihren Zugangsdaten an
  2. Klicken Sie auf "Einladungen" im Menü
  3. Wählen Sie ein Credit-Paket und bezahlen Sie sicher via Stripe
  4. Die Credits stehen sofort zur Verfügung
Zugangsdaten vergessen? Kontaktieren Sie uns unter ralph.koebler@potenzial.at

Bereit loszulegen?

Registrieren Sie sich jetzt und integrieren Sie Potenzialanalysen in Ihre Software.