API Errors

Ver todos os erros

Quando uma API da Vonage retorna um erro — por exemplo, se sua conta não tiver crédito —, a API retornará um erro no formato RFC 7807.

Isso fornece uma explicação básica sobre qual é o problema, por que ele ocorreu e quais são as etapas para resolvê-lo. Confira o exemplo para ver como um relatório de resolução de problema ( out-of-credit ) é formatado.

Provavelmente, você vai querer avaliar desde o início quais erros seu aplicativo precisará tratar; esta página fornece uma lista de todos os erros possíveis que podem ocorrer, com uma explicação mais detalhada de como lidar com eles.

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

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

Erros de API

API do Verify.V2