Erreurs de l'API

Lorsqu'une API de Vonage renvoie une erreur, par exemple si votre Account n'a pas de crédit, l'API renvoie une erreur au format RFC 7807.

Il s'agit d'une explication de base du problème, de sa cause et des mesures à prendre pour le résoudre. Consultez l'exemple pour voir comment un out-of-credit est formaté.

Cette page fournit une liste de toutes les erreurs possibles qui peuvent se produire, ainsi qu'une explication plus détaillée de la manière dont elles peuvent être traitées.

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

Code	Informations
`fragment-exists`	Description A template fragment for this channel and locale already exists Résolution Change either the locale or channel to a combination not being used
`template-fragment-not-found`	Description Template Fragment not found Résolution Check the ID of the template fragment you are trying to access
`template-not-found`	Description Template not found Résolution Check the ID of the template you are trying to access
`template-exists`	Description A template with this name already exists Résolution Choose a different template name in the request
`not-empty-template`	Description The template is not empty and cannot be deleted. Please delete its fragments first Résolution Delete the individual template fragments, then try again
`forbidden`	Description Templates management is not enabled for your account Résolution Contact Vonage support to enable custom template management
`expired`	Description An incorrect code has been provided too many times. Workflow terminated. Résolution Request a new Verification
`no-code`	Description The current Verify workflow step does not support a code. Résolution Change to a valid workflow to handle your request
`max-templates`	Description An account can only have a maximum of 10 custom templates Résolution Delete a template before retrying
`concurrent`	Description Concurrent verifications to the same number are not allowed. Résolution In flight verification needs to expire, fail or be completed
`invalid-code`	Description The code you provided does not match the expected value. Résolution Retry with the correct value or fail the request
`no-events`	Description The code you provided does not match the expected value. Résolution Retry with the correct value or fail the request
`request-not-found`	Description The request ID provided could not be found. Résolution Retry with a valid request ID
`msisdn-error`	Description The device MSISDN does not match. Résolution Silent Auth will not work with this device, try a different one.
`precondition-failed`	Description Conditions for the Silent Auth request to complete have not been met. Résolution Silent Auth will not work with this device, try a different one.
`network-error`	Description The Silent Auth request could not be completed due to formatting or the carrier is not supported. Résolution Check https://developer.vonage.com/en/verify/guides/silent-auth-territories?source=verify to see if the carrier(s) used are supported.