APIエラー

Vonage APIがエラーを返した場合、例えばアカウントにクレジットがない場合、APIはRFC 7807フォーマットでエラーを返します。

これは、問題が何であるか、なぜそれが発生したか、それを解決するための手順の基本的な説明を提供します。クレジット不足がどのような形式で表示されるかは、例を参照してください。

アプリケーションがどのようなエラーを処理する必要があるか、前もって考えておくといいかもしれません。このページでは、発生しうるすべてのエラーのリストと、その対処方法についてのより詳細な説明を提供しています。

Verify.V2 API

CodeInformation
fragment-exists

Description

A template fragment for this channel and locale already exists

Resolution

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

template-fragment-not-found

Description

Template Fragment not found

Resolution

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

template-not-found

Description

Template not found

Resolution

Check the ID of the template you are trying to access

template-exists

Description

A template with this name already exists

Resolution

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

Resolution

Delete the individual template fragments, then try again

forbidden

Description

Templates management is not enabled for your account

Resolution

Contact Vonage support to enable custom template management

expired

Description

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

Resolution

Request a new Verification

no-code

Description

The current Verify workflow step does not support a code.

Resolution

Change to a valid workflow to handle your request

max-templates

Description

An account can only have a maximum of 10 custom templates

Resolution

Delete a template before retrying

concurrent

Description

Concurrent verifications to the same number are not allowed.

Resolution

In flight verification needs to expire, fail or be completed

invalid-code

Description

The code you provided does not match the expected value.

Resolution

Retry with the correct value or fail the request

no-events

Description

The code you provided does not match the expected value.

Resolution

Retry with the correct value or fail the request

request-not-found

Description

The request ID provided could not be found.

Resolution

Retry with a valid request ID

msisdn-error

Description

The device MSISDN does not match.

Resolution

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.

Resolution

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.

Resolution

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