Fehlercodes

Ein Fehler antwortet immer mit einem HTTP-Status und einem JSON-Body:

{ "error": "Lesbare Meldung", "code": "internal_error" }

error beschreibt das Problem; code ist nur bei bestimmten Fehlern vorhanden und ändert sich nicht von einer Version zur nächsten.

Status	Bedeutung	Vorgehen
400	Ungültiger Body, leeres Pflichtfeld oder company_id, die nicht aus 32 Hexadezimalzeichen besteht.	Die Anfrage korrigieren.
401	company_id fehlt, oder der Wert im Header weicht von dem im Body ab.	Den Header Authorization prüfen.
402	Nicht genügend Credits, um den Ablauf zu starten. Der Bewerber wurde nicht kontaktiert.	Die Credits des Unternehmens aufladen und dann erneut starten.
409	Das Stellenangebot ist bereits einem anderen Unternehmen zugeordnet (ats_offer_owned_by_another_org).	Die ID des Stellenangebots und das aufrufende Unternehmen prüfen.
422	In einem Batch wurde keine Sitzung erstellt: Alle Bewerber wurden abgelehnt.	Die zurückgegebenen Gründe lesen, die Daten korrigieren.
500	Interner Fehler (code: internal_error), ohne Details.	Später erneut versuchen. Eine Zuweisung kann ohne Risiko eines Duplikats wiederholt werden.

Ablehnungsgründe in einem Batch

In einem Batch erscheint jeder abgelehnte Bewerber in failed mit seinem Grund (reason) und, falls vorhanden, einer lesbaren Erläuterung (detail):

Grund	Bedeutung
INVALID_DATA	Unmögliche Telefonnummer, fehlende E-Mail-Adresse oder unlesbares Anrufdatum.
DUPLICATE_PHONE_IN_BATCH	Dieselbe Nummer erscheint zweimal im Batch.
DUPLICATE_ACTIVE_SESSION	Der Bewerber hat für diese Bewertung bereits eine aktive Sitzung.
INSUFFICIENT_CREDITS	Das Unternehmen hat nicht mehr genügend Credits.