Verify Return and Error Codes
As a RESTful API, Twilio's Verify API will return HTTP responses and error codes which will help verify normal behavior as well as contextualize exceptions.
リターンコード
下記のステータス・コードが使用されます。
200200: OK - レスポンスは正常です。 レスポンス本文にはリクエストされたデータが含まれます。
400400: Bad Request - リクエストにエラーが発生しました。 レスポンス本文には詳細が含まれます。
401: Unauthorized トークンが無効です。 APIキーが誤っている場合に401が生成されます。 APIキーを確認してください。
429Too Many Requests APIの使用制限に達しました。 APIの利用制限に達した場合、429が返されます。 制限解除まで待って、再度呼び出しを試みてください。
503: Service Unavailable HTTP 503 エラーには複数の原因の可能性があります。
- 内部Twilioエラー
- アクセス権限のないAPIを呼び出そうとしている
エラーコード
APIが200以外のレスポンスを返すとき、メッセージBodyにエラーコードを付加します。 この表では取りうる全エラーコードを列挙、解説しています。
| エラー コード | HTTPステータス | エラーメッセージ | 概要 | Category |
|---|---|---|---|---|
| 60000 | 400 | An error occurred | エラーが正しく構成されていない場合の既定のエラーメッセージです。 | すべて |
| 60001 | 401 | Invalid API key | 指定されたAPIキーに対応するAuthyアプリケーションがありません | すべて |
| 60002 | 400 | Invalid request | リクエストに無効なパラメーターまたはデータが含まれています | すべて |
| 60003 | 429 | DoS protection | 指定されたエンドポイントに対して、クライアントが単位時間あたりのリクエストの最大数に達しました。 | すべて |
| 60004 | 400 | Invalid parameter | 指定されたパラメーターが無効です。 | すべて |
| 60005 | 400 | UTF-8 invalid | クライアントがUTF-8の無効な文字でリクエストを送信しました | すべて |
| 60021 | 403 | Phone verification couldn't be created | 電話番号検証の作成時に発生するエラーです | 電話番号認証 |
| 60022 | 401 | Verification code is incorrect | 不正な電話番号検証コードです | 電話番号認証 |
| 60023 | 404 | Phone verification not found | 指定されたパラメーターの電話番号検証が見つかりませんでした | 電話番号認証 |
| 60032 | 400 | SMS was not found | 指定されたSMS IDでレコードが見つからなかった場合にFacebook APIによって使用されます | フィードバック |
| 60033 | 400 | Phone number is invalid | 電話番号または国コードが無効です | すべて |
| 60042 | 400 | Either uuid or country_code and phone number are required | 電話番号検証における無効なパラメーターです | 電話番号認証 |
| 60046 | 400 | Missing dashboard account ids to process | 続行するにはアカウントIDが必須です | Dashboard |
| 60060 | 503 | Your account is suspended | Twilioアカウントがサスペンドされています | 電話番号認証 |
| 60064 | 403 | Failed to enable OneTouch | onetouchをオンにする際アプリケーション設定を更新できません | Dashboard |
| 60065 | 403 | Needs to enable OneTouch first | アプリケーションでonetouchがオンになっていないにも関わらずonetouchリクエストの実行を試みました | Dashboard |
| 60066 | 403 | Error saving the callback information | コールバック情報でアプリケーション設定を更新できません | Dashboard |
| 60069 | 400 | Access key can not be saved | アクセスキーの作成において、そのアクセスキーが無効です | Dashboard |
| 60070 | 400 | Application was not valid | アプリケーションの作成または更新時、そのアプリケーションが有効ではありませんでした | Dashboard |
| 60071 | 404 | Access key not found | Access key not found | Dashboard |
| 60072 | 404 | Invalid access key | アクセスキーが不正です | Dashboard |
| 60073 | 400 | Invalid application API key | アプリケーションAPIキーが不正です | Dashboard |
| 60074 | 400 | Access key doesn't have enough permissions | 指定されたアクセスキーに、URLにアクセスするための十分な権限がありません | Dashboard |
| 60075 | 400 | Delete application failed | いくつかの特殊な状況のためアプリケーションを削除できません。 アプリケーション削除の実行時にまだユーザーが存在しているか、保留中のインボイスがある際のエラーです | Dashboard |
| 60078 | 403 | Invalid country code | 指定された国コードが有効ではありません | すべて |
| 60082 | 403 | Can not send SMS to landline phone numbers | 固定電話の番号にSMS送信を試みた際のエラーです | 電話番号認証 |
| 60083 | 403 | Phone number not provisioned with any carrier | 準備されていない電話番号に電話番号検証の送信を試みた際のエラーです | 電話番号認証 |
ヘルプが必要ですか？
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。