Authyのリターンコードとエラーコード
RESTful APIとして、TwilioのAuthy APIはHTTPレスポンスとエラーコードを返します。 これは通常の振る舞いと状況に応じた例外の確認に役立ちます。
リターンコード
下記のステータス・コードが使用されます。
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の無効な文字でリクエストを送信しました | すべて |
| 60006 | 503 | Phone calls are not enabled on this account | アプリケーションで音声通話がオンになっていません（ダッシュボードからオンにすることができます） | TOTP |
| 60007 | 503 | SMS is not enabled | アプリケーションでSMSがオンになっていません（ダッシュボードからオンにすることができます） | TOTP |
| 60008 | 403 | Your account is suspended | Twilio側または内部的な理由でアカウントがサスペンドされています。 | TOTP |
| 60009 | 429 | Monthly SMS limit reached | アプリケーションが月次のSMS送信制限に達しました | TOTP |
| 60010 | 429 | Daily SMS limit reached | アプリケーションが日次のSMS送信制限に達しました | TOTP |
| 60011 | 429 | Monthly Phone Calls limit reached | アプリケーションは月次の音声通話の制限に達しました | TOTP |
| 60012 | 429 | Daily Phone Calls limit reached | アプリケーションは日次の音声通話の制限に達しました | TOTP |
| 60013 | 503 | Country code is banned | 禁止された国コードのためリクエストを完了できませんでした | TOTP |
| 60014 | 503 | Call was not started | 通話の発進時に発生するエラーです | TOTP |
| 60015 | 503 | SMS token was not sent | SMSのTOTPが送信されない内部エラーです | TOTP |
| 60016 | 401 | User doesn't exist | 指定されたユーザーIDに対応するユーザーが存在しませんでした | TOTP |
| 60017 | 503 | User suspended | ユーザーがサスペンドされたためアクションを完了できませんでした | TOTP |
| 60018 | 503 | User disabled | ユーザーのデバイスがサスペンドされたためアクションを完了できませんでした | TOTP |
| 60019 | 401 | Token reused | 指定されたトークンは以前使用されたものであり、二度は使用出来ません | TOTP |
| 60020 | 401 | Token invalid | 指定されたトークンが無効です | TOTP |
| 60021 | 403 | Phone verification couldn't be created | 電話番号検証の作成時に発生するエラーです | 電話番号認証 |
| 60022 | 401 | Verification code is incorrect | 不正な電話番号検証コードです | 電話番号認証 |
| 60023 | 404 | Phone verification not found | 指定されたパラメーターの電話番号検証が見つかりませんでした | 電話番号認証 |
| 60024 | 403 | Couldn't get phone information | 電話番号情報の取得に失敗しました | 電話番号情報 |
| 60025 | 503 | Server error while querying phone information. Please try again later | 電話番号情報照会時の内部エラーです | 電話番号情報 |
| 60026 | 404 | User doesn't exist | 指定されたユーザーIDに対応するユーザーが存在しませんでした | ユーザー管理 |
| 60027 | 400 | User was not valid | ユーザーが無効で保存できません | ユーザー管理 |
| 60028 | 403 | The user cannot be deleted | ユーザーの削除時にエラーが発生しました | ユーザー管理 |
| 60029 | 403 | Activity couldn't be created | ユーザーに対するアクティビティーの作成時にエラーが発生しました | ユーザー管理 |
| 60030 | 400 | You are not passing the user params correctly | ユーザーパラメーターが不正です | ユーザー管理 |
| 60031 | 403 | Action not authorized | 顧客にアクション完了の権限がありません | ユーザー管理 |
| 60032 | 400 | SMS was not found | 指定されたSMS IDでレコードが見つからなかった場合にFacebook APIによって使用されます | フィードバック |
| 60033 | 400 | Phone number is invalid | 電話番号または国コードが無効です | すべて |
| 60034 | 400 | Invalid registration request | 登録リクエストの作成でエラーが発生しました | Registration |
| 60035 | 404 | Registration request not found | 指定されたパラメーターで登録リクエストが見つかりませんでした | Registration |
| 60036 | 401 | Invalid registration PIN | 受信した登録暗証番号が不正です | Registration |
| 60037 | 403 | Registration request expired | 登録リクエストは1時間後に期限切れとなります | Registration |
| 60038 | 403 | Email is invalid | ユーザーが無効なメールアドレスを入力しました | TOTP |
| 60042 | 400 | Either uuid or country_code and phone number are required | 電話番号検証における無効なパラメーターです | 電話番号認証 |
| 60046 | 400 | Missing dashboard account ids to process | 続行するにはアカウントIDが必須です | Dashboard |
| 60047 | 403 | Invalid API key.Confirm your API key by going to https://dashboard.authy.com | リクエストがAuthy APIキーではなくTwilio APIキーを使用してなされた場合のエラーです | TOTP |
| 60049 | 404 | Onetouch Approval request not found | Onetouch Approval request not found | OneTouch |
| 60050 | 404 | Onetouch Unregistered user | アプリケーションにユーザーが追加されていません | OneTouch |
| 60051 | 404 | Onetouch device not found | ユーザーは指定されたアプリケーション用のonetouchデバイスを所持していません | OneTouch |
| 60052 | 400 | An error ocurred sending the approval request.Internal connection error | onetouchサービスとの通信エラーです | OneTouch |
| 60053 | 400 | An error ocurred sending the approval request | 承認リクエストが作成できなかった際のエラーです | OneTouch |
| 60054 | 400 | An error ocurred on approval request | 承認リクエストが保留中ではなく、かつ承認リクエストが受信された際のエラーです | OneTouch |
| 60055 | 400 | An error ocurred notifying customer | onetouch承認リクエストがユーザーに通知できなかった際のエラーです | OneTouch |
| 60056 | 505 | You must use https protocol to use this api | 本番用の全リクエストはHTTPSで送信される必要があります | TOTP |
| 60057 | 503 | Your account has been suspended temporarily | ユーザーが送信量制限を超過した際に応答されます | TOTP |
| 60058 | 404 | Phone number not found | Phone number not found | TOTP |
| 60059 | 404 | Phone number is invalid | 電話番号が有効ではない際のエラーです | TOTP |
| 60060 | 503 | Your account is suspended | Twilioアカウントがサスペンドされています | 電話番号認証 |
| 60061 | 503 | Your application is suspended | Your application is suspended | TOTP |
| 60063 | 403 | Disallowed ip address | 公開エンドポイントとして使用に対してブロックされているIPアドレスです | TOTP |
| 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 |
| 60067 | 403 | Access blocked for user with multidevices | ユーザーが電話機の変更を行う際、複数のデバイスが有効になっていないとこのエラーが発生します | TOTP |
| 60068 | 401 | Can not update device in registration | デバイス登録でデバイスが無効であり、変更をデバイスに保存できませんでした | Registration |
| 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 | 指定された国コードが有効ではありません | すべて |
| 60079 | 400 | Approval request is not pending | 承認リクエストが保留中でないため、アクションを実行できません | OneTouch |
| 60080 | 400 | Approval request is invalid | 承認リクエストが無効なため保存できません | OneTouch |
| 60082 | 403 | Can not send SMS to landline phone numbers | 固定電話の番号にSMS送信を試みた際のエラーです | 電話番号認証 |
| 60083 | 403 | Phone number not provisioned with any carrier | 準備されていない電話番号に電話番号検証の送信を試みた際のエラーです | 電話番号認証 |
| 60085 | 403 | Cannot execute action because OneTouch is not enabled |
アクションの実行前に、OneTouchをオンにしておくことが必要です。 |
OneTouch |
| 60133 | 403 | Canadian number. Further authorization required – contact our Support Team |
More information: Twilio Lookups API is Not Returning Carrier Data for Canadian Phone Numbers |
電話番号情報 |
ヘルプが必要ですか？
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。