ビジネス要件に基づいて、Phone Number Verification Service をビジネスシステムと統合して、複数チャネルのクイック検証 などの機能を実装できます。 これにより、ビジネスオペレーションの簡素化とコストの管理に役立ちます。 このトピックでは、電話番号検証サービス の API オペレーションの呼び出し方法に関する基本情報と使用上の注意について説明します。
サーバー側の統合
Phone Number Verification Service は、ショートメッセージサービス ( SMS ) 検証など、複数の機能を提供しています。 Alibaba Cloud SDK を使用して電話番号検証サービスを統合し、 API オペレーションを呼び出すことで、これらの機能を使用できます。
OpenAPI エクスプローラー
Alibaba Cloud は OpenAPI エクスプローラーを提供しており、API オペレーションを呼び出すことで、クラウドのリソース、データ、サービスを簡単に管理できます。 詳細については、API とは をご参照ください。
API バージョン
API バージョン | 説明 |
この API バージョンを使用することをお勧めします。 |
2017-07-25 は日付ではなく、API のバージョン番号です。 2017-07-25 は電話番号検証サービス API の最新バージョンであり、API に関する最新の公開情報を提供します。
エンドポイント
レイテンシを削減するために、リソースが存在するリージョンに基づいてエンドポイントを選択します。
グローバルエンドポイントは dypnsapi-intl.ap-southeast-1.aliyuncs.com です。
詳細については、エンドポイント をご参照ください。
ID
Phone Number Verification Service では、次の ID を使用して API オペレーションを呼び出すことができます。 アプリケーションに必要な権限が付与された Resource Access Management ( RAM ) ユーザー または RAM ロール として電話番号検証サービスの API オペレーションを呼び出すことをお勧めします。
ID | サポート |
はい | |
(推奨) RAM ユーザー | はい |
(推奨) RAM ロール | はい |
Alibaba Cloud アカウントで OpenAPI エクスプローラーにログインすると、OpenAPI エクスプローラーはデフォルトで Alibaba Cloud アカウントを使用して API オペレーションをオンラインでデバッグします。 Alibaba Cloud アカウントは、すべての API オペレーションに対する権限を持っています。 Alibaba Cloud アカウントを使用して API オペレーションを呼び出すと、セキュリティリスクが発生する可能性があります。 API オペレーションの呼び出しやルーチン O&M は RAM ユーザーとして実行することをお勧めします。 RAM ユーザーとして API オペレーションを呼び出す前に、ビジネス要件に基づいて RAM ユーザーに必要な権限を付与してください。 RAM ユーザーは操作権限を持っている必要があります。 詳細については、RAM を使用したアクセス制御 をご参照ください。
オンラインデバッグ
Alibaba Cloud は OpenAPI エクスプローラーを提供しており、さまざまな Alibaba Cloud サービスの API オペレーションを効率的に理解し、使用できます。 OpenAPI エクスプローラーは、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK ダウンロード、サンプルコード、呼び出しエラー診断、呼び出し統計など、API オペレーションに関連する次の機能を統合しています。 OpenAPI エクスプローラーでは、Alibaba Cloud サービスの API オペレーションを呼び出し、API リクエストとレスポンスを表示できます。 また、OpenAPI エクスプローラーは、Alibaba Cloud サービスの使用を容易にするために、対応する SDK サンプルコードを自動的に生成します。
https://api.alibabacloud.com/api/Dypnsapi-intl/2017-07-25/ で API のデバッグを実行できます。
統合方法
ビジネス要件に基づいて、Alibaba Cloud SDK などのさまざまな統合方法を使用して、Phone Number Verification Service をビジネスシステムと統合できます。
Alibaba Cloud SDK
Alibaba Cloud は、複数のプログラミング言語で SDK を提供しています。 SDK をアプリケーションに統合して、API オペレーションを直接呼び出すことができます。 SDK は、署名ロジック、タイムアウトメカニズム、再試行メカニズムなどの情報をカプセル化し、仕様に基づいて構造化されたレスポンスオブジェクトを返します。 これにより、開発が容易になります。 詳細については、Alibaba Cloud SDK をご参照ください。
さまざまなプログラミング言語でサポートされている Phone Number Verification Service SDK と依存関係のインストールの詳細については、サーバー SDK リファレンス をご参照ください。
API オペレーションのリクエストのカプセル化
上記のメソッドがビジネス要件を満たしていない場合は、API オペレーションのリクエストをカプセル化し、対応するオペレーションを呼び出すことができます。 このメソッドは推奨されません。 詳細については、リクエスト構文と署名メソッド V3 をご参照ください。
使用上の注意
電話番号検証サービスの API オペレーションを呼び出した後にエラーが返された場合は、返されたエラーコードに基づいて、リクエストパラメーターと値が有効かどうかを確認する必要があります。 詳細については、検証 - エラーコード をご参照ください。
OpenAPI 問題診断 にアクセスして、返されたリクエスト ID または SDK エラー情報に基づいてセルフサービス診断を実行することもできます。