API-Fehler

Wenn eine Vonage-API einen Fehler zurückgibt, z. B. wenn Ihr Account kein Guthaben hat, gibt die API einen Fehler im Format RFC 7807 zurück.

Hier finden Sie eine grundlegende Erklärung, was das Problem ist, warum es auftrat und wie es zu beheben ist. Anhand des Beispiels können Sie sehen, wie ein out-of-credit formatiert ist.

Auf dieser Seite finden Sie eine Liste mit allen möglichen Fehlern, die auftreten können, und eine genauere Erklärung, wie sie behoben werden können.

HTTP/1.1 403 Forbidden
Content-Type: application/problem+json
Content-Language: en
{
  "type": "https://example.com/Error#out-of-credit",
  "title": "You do not have enough credit",
  "detail": "Your current balance is 30, but that costs 50.",
  "instance": "<trace_id>"
}

Verify.V2 API

CodeInformationen
fragment-exists

Beschreibung

A template fragment for this channel and locale already exists

Auflösung

Change either the locale or channel to a combination not being used

template-fragment-not-found

Beschreibung

Template Fragment not found

Auflösung

Check the ID of the template fragment you are trying to access

template-not-found

Beschreibung

Template not found

Auflösung

Check the ID of the template you are trying to access

template-exists

Beschreibung

A template with this name already exists

Auflösung

Choose a different template name in the request

not-empty-template

Beschreibung

The template is not empty and cannot be deleted. Please delete its fragments first

Auflösung

Delete the individual template fragments, then try again

forbidden

Beschreibung

Templates management is not enabled for your account

Auflösung

Contact Vonage support to enable custom template management

expired

Beschreibung

An incorrect code has been provided too many times. Workflow terminated.

Auflösung

Request a new Verification

no-code

Beschreibung

The current Verify workflow step does not support a code.

Auflösung

Change to a valid workflow to handle your request

max-templates

Beschreibung

An account can only have a maximum of 10 custom templates

Auflösung

Delete a template before retrying

concurrent

Beschreibung

Concurrent verifications to the same number are not allowed.

Auflösung

In flight verification needs to expire, fail or be completed

invalid-code

Beschreibung

The code you provided does not match the expected value.

Auflösung

Retry with the correct value or fail the request

no-events

Beschreibung

The code you provided does not match the expected value.

Auflösung

Retry with the correct value or fail the request

request-not-found

Beschreibung

The request ID provided could not be found.

Auflösung

Retry with a valid request ID

msisdn-error

Beschreibung

The device MSISDN does not match.

Auflösung

Silent Auth will not work with this device, try a different one.

precondition-failed

Beschreibung

Conditions for the Silent Auth request to complete have not been met.

Auflösung

Silent Auth will not work with this device, try a different one.

network-error

Beschreibung

The Silent Auth request could not be completed due to formatting or the carrier is not supported.

Auflösung

Check https://developer.vonage.com/en/verify/guides/silent-auth-territories?source=verify to see if the carrier(s) used are supported.