Header Authorization: Bearer spk_live_... prüfen, sonst neuen Schlüssel anlegen.
insufficient_scope
403
Dem Schlüssel fehlt die Berechtigung. details.required_scope nennt sie.
Neuen Schlüssel mit dieser Berechtigung anlegen.
invalid_request
400
Die Anfrage ist ungültig: falsches Feld, falscher Wert oder kein gültiges JSON.
details.fields lesen und die Anfrage korrigieren. Nicht unverändert wiederholen.
not_found
404
Die ID oder der Pfad ist unbekannt. Auch IDs fremder Organisationen sind „nicht gefunden“.
ID und Adresse prüfen.
conflict
409
Die Anfrage passt nicht zum aktuellen Zustand, zum Beispiel Abbrechen eines laufenden Anrufs oder ein schon benutzter Idempotency-Key mit anderem Body.
Aktuellen Stand abfragen und danach entscheiden.
rate_limited
429
Zu viele Anfragen in einer Minute.
So lange warten, wie der Header retry-after angibt, dann wiederholen.
internal_error
500
Fehler bei SpeakKI.
Später wiederholen, bei POST /v1/calls mit demselben Idempotency-Key. Hält es an, schreiben Sie dem Support.
"message": "Ungültige Anfrage (to): Bitte geben Sie eine Zielnummer an.",
"details": {
"in": "body",
"fields": { "to": "Bitte geben Sie eine Zielnummer an." }
}
}
}
details.in nennt die Stelle: body, query, params oder header. details.fields nennt je Feld die Meldung. Unbekannte Felder führen ebenfalls zu invalid_request. Ist die Anfrage zu groß, kommt der Code mit Status 413, bei falschem Content-Type mit Status 415.
Diese Codes kommen, wenn ein Anruf oder eine Kampagne gegen eine Regel verstößt. Es entsteht dann kein Anruf. Dieselben Codes stehen in block_reason eines Anrufs mit dem Status blocked und in skip_reason eines übersprungenen Empfängers.