Errores de API

Cuando una API de Vonage devuelve un error, por ejemplo, si tu Account no tiene crédito, la API devolverá un error en formato RFC 7807.

Esto proporciona una explicación básica de cuál es el problema, por qué se produjo y los pasos para resolverlo. Echa un vistazo al ejemplo para ver cómo se formatea un fuera de crédito.

En esta página encontrará una lista de todos los posibles errores que pueden producirse, junto con una explicación más detallada de cómo solucionarlos.

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>"
}

API Verify.V2

CódigoInformación
fragment-exists

Descripción

A template fragment for this channel and locale already exists

Resolución

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

template-fragment-not-found

Descripción

Template Fragment not found

Resolución

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

template-not-found

Descripción

Template not found

Resolución

Check the ID of the template you are trying to access

template-exists

Descripción

A template with this name already exists

Resolución

Choose a different template name in the request

not-empty-template

Descripción

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

Resolución

Delete the individual template fragments, then try again

forbidden

Descripción

Templates management is not enabled for your account

Resolución

Contact Vonage support to enable custom template management

expired

Descripción

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

Resolución

Request a new Verification

no-code

Descripción

The current Verify workflow step does not support a code.

Resolución

Change to a valid workflow to handle your request

max-templates

Descripción

An account can only have a maximum of 10 custom templates

Resolución

Delete a template before retrying

concurrent

Descripción

Concurrent verifications to the same number are not allowed.

Resolución

In flight verification needs to expire, fail or be completed

invalid-code

Descripción

The code you provided does not match the expected value.

Resolución

Retry with the correct value or fail the request

no-events

Descripción

The code you provided does not match the expected value.

Resolución

Retry with the correct value or fail the request

request-not-found

Descripción

The request ID provided could not be found.

Resolución

Retry with a valid request ID

msisdn-error

Descripción

The device MSISDN does not match.

Resolución

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

precondition-failed

Descripción

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

Resolución

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

network-error

Descripción

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

Resolución

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