Candidate Intelligence API-Integration

Ideal für

Partnervorteile

Warum Candidate Intelligence integrieren?

Bieten Sie Ihren Kunden zusätzlichen Kontext vor Interviews und schaffen Sie gleichzeitig neuen Mehrwert in Ihrer Plattform.

Integrationsablauf

Leistung und Latenz

Candidate Intelligence ist darauf ausgelegt, Recruitern ein reaktionsschnelles Erlebnis direkt in ihren Workflows zu bieten.

Logik zur Berichtswiederverwendung

Berichte werden eindeutig über Plattform + Unternehmen + Kandidat identifiziert.

Authentifizierung

X-API-Key: ats_your_api_key_here
Content-Type: application/json

Analyse erstellen

{
  "language": "en",
  "client": {
    "id": "client_company_123",
    "first_name": "Jane",
    "last_name": "Smith",
    "company": "Acme Recruiting"
  },
  "candidate": {
    "id": "candidate_456",
    "first_name": "John",
    "last_name": "Doe",
    "company": "Example Company",
    "location": "London, UK",
    "role": "Software Engineer",
    "cv": "Optional plain-text CV content…"
  }
}

202 Accepted

Der Location-Header verweist auf GET /api/v1/analyses/'{'id'}'. Retry-After: 10 gibt an, wann das nächste Polling erfolgen soll.

{
  "id": "cmqp23kgg00067gk0rh6jol5o",
  "status": "queued",
  "candidate_id": "candidate_456",
  "created_at": "2026-06-29T12:00:00.000Z"
}

Polling und progressive Ergebnisse

Nach einem POST mit 202 Accepted rufen Sie GET /api/v1/analyses/'{'id'}' mit demselben X-API-Key-Header ab. Verwenden Sie die ID aus der Erstellungsantwort.

Solange der Status queued oder processing ist, enthält jede GET-Antwort Retry-After: 10 — warten Sie mindestens 10 Sekunden vor der nächsten Anfrage.

Beenden Sie das Polling, wenn der Status completed, failed oder canceled ist.

{
  "id": "cmqp23kgg00067gk0rh6jol5o",
  "status": "processing",
  "candidate_id": "candidate_456",
  "stage": "enrichment",
  "created_at": "2026-06-29T12:00:00.000Z",
  "updated_at": "2026-06-29T12:00:20.000Z",
  "quick_signal": {
    "level": "Green",
    "reason": "Identity supported by multiple matching signals.",
    "identityConfidence": "Medium"
  },
  "signals": [
    {
      "statement": "Senior engineer at Example Company since 2021.",
      "sourceType": "web",
      "sourceUrl": "https://example.com/…",
      "reliability": "High"
    }
  ],
  "report": null,
  "metadata": null,
  "error": null
}

Felder, die während der Verarbeitung befüllt werden

Statuswerte

Analyse abbrechen

DELETE /api/v1/analyses/'{'id'}' stoppt eine wartende oder laufende Analyse, wenn ein Recruiter das Kandidatenprofil verlässt oder einen laufenden Bericht verwirft. Verwenden Sie denselben X-API-Key-Header wie bei POST und GET.

Ist die Analyse bereits completed, failed oder canceled, gibt der Endpunkt die aktuelle Ressource unverändert zurück — keine zusätzlichen Kosten oder Nebenwirkungen.

// Kein Request-Body — nur X-API-Key-Header

200 OK

Gibt die Analyse-Ressource mit Status canceled zurück. Teilweise quick_signal oder signals können vorhanden sein, wenn der Abbruch mitten in der Pipeline erfolgte. Beenden Sie das Polling, sobald der Status canceled ist.

{
  "id": "cmqp23kgg00067gk0rh6jol5o",
  "status": "canceled",
  "candidate_id": "candidate_456",
  "stage": "enrichment",
  "created_at": "2026-06-29T12:00:00.000Z",
  "updated_at": "2026-06-29T12:00:25.000Z",
  "quick_signal": null,
  "signals": [],
  "report": null,
  "metadata": null,
  "error": null
}

Abgeschlossene Analyse

Wird zurückgegeben, wenn der Status completed ist.

{
  "id": "clx_analysis_id",
  "status": "completed",
  "candidate_id": "candidate_456",
  "stage": "done",
  "created_at": "2026-06-29T12:00:00.000Z",
  "updated_at": "2026-06-29T12:00:45.000Z",
  "quick_signal": {
    "level": "Green",
    "reason": "Identity supported by multiple matching signals.",
    "identityConfidence": "Medium"
  },
  "signals": [
    {
      "statement": "…",
      "sourceType": "web",
      "reliability": "High"
    }
  ],
  "report": {
    "candidateName": "John Doe",
    "recommendation": {
      "decision": "GO with validation",
      "confidence": "Medium",
      "reason": "…",
      "evidence": ["…"]
    },
    "summary": "…",
    "whatToValidate": ["…"]
  },
  "metadata": {
    "report_id": "clx_analysis_id",
    "candidate_id": "candidate_456",
    "language": "en",
    "generated_at": "2026-06-29T12:00:45.000Z",
    "pdf_download_url": "https://intelligence.tietalent.com/api/ats/reports/{id}/pdf?sig=…"
  },
  "error": null
}

Empfohlene Partner-Oberfläche

Schaltfläche in Kandidatenprofilen hinzufügen

Fügen Sie eine Schaltfläche „Candidate Intelligence-Bericht starten“ in Kandidatenprofilen hinzu. Beim Klick wechselt sie zu „Bericht wird erstellt...“ während der Generierung. Sobald der Bericht fertig ist, öffnet er sich automatisch und die Schaltfläche wird zu „✕ Bericht schließen“. Nach dem Schließen wechselt sie zu „Intelligence-Bericht ansehen“, um einen bereits gespeicherten Bericht erneut zu öffnen — ohne erneut POST aufzurufen.

Datenschutz und Sicherheit