Erreurs API

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

Ce document fournit une explication sommaire de la nature du problème, des causes de son apparition et des étapes à suivre pour le résoudre. Consultez l'exemple pour voir comment est structuré un rapport d'out-of-credit.

Vous aurez sans doute intérêt à réfléchir dès le départ aux erreurs que votre application devra gérer ; cette page fournit une liste de toutes les erreurs possibles, accompagnée d'explications détaillées sur la manière de les résoudre.

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 des sous-comptes

CodeInformationsActions
validation

Description

The request failed due to validation errors

Résolution

See the detail (and, if present, the invalid_parameters) fields for the exact reason this request was rejected and review the documentation.

invalid-transfers

Description

Invalid transfer

Résolution

See the detail field for the reason this transfer is invalid.

provisioning

Description

Maximum number of sub-accounts reached

Résolution

If you need more subaccounts, contact Vonage Support.

internal-error

Description

An error has occurred in the platform while processing this request

Résolution

If the error persists, contact Vonage Support.

invalid-number-transfer

Description

Failed to perform transfer number from source account to destination account

Résolution

See the detail field for the reason this transfer is invalid.

missing-number-transfer

Description

Could not transfer number from source account to destination account - ShortCode not found

Résolution

See the detail field for the reason this transfer is invalid.

transfer-conflict

Description

Could not transfer number from source account to destination account - ShortCode is already owned by requesting account

Résolution

See the detail field for the reason this transfer is invalid.