cURLの使用
このドキュメント内の例では、cURLを使用して、Address, Email, and Phone Verification Cloud REST APIにアクセスする方法を示します。
タスク1: cURLのインストール
サーバーに安全に接続するには、SSLをサポートし、Verisign CA証明書に対して認証するSSL認証局(CA)証明書ファイルまたはバンドルを提供するバージョンのcURLをインストールする必要があります。 認証の詳細は、「認証」を参照してください。
次の手順は、Windows 64?bitシステムにcURLをインストールする方法を示しています。
-
ブラウザで、http://curl.haxx.seのcURLホーム・ページに移動し、左側のナビゲーション・メニューで「ダウンロード」をクリックします。
-
「cURL Releases and Downloads」ページで、オペレーティング・システムに応じたSSL対応バージョンのcURLソフトウェアを探します。ZIPファイルをダウンロードするリンクをクリックし、ソフトウェアをインストールします。
-
http://curl.haxx.se/docs/caextract.htmlのcURL「CA証明書」ページに移動し、cURLをインストールしたフォルダのca-bundle.crt SSL CA証明書バンドルをダウンロードします。
-
コマンド・ウィンドウを開き、cURLをインストールしたディレクトリに移動し、cURL環境変数
CURL_CA_BUNDLE
をSSL認証局(CA)証明書バンドルのロケーションに設定します。 たとえば:C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt
これで、cURLを使用してリクエストを送信する準備ができました。
タスク2: cURLの環境変数の設定
コマンド・ウィンドウで、cURL環境変数CURL_CA_BUNDLE
をローカルCA証明書バンドルのロケーションに設定します。 たとえば:
C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt
cURLを使用したCA証明書の検証の詳細は、http://curl.haxx.se/docs/sslcerts.htmlを参照してください。
タスク3: cURLの起動
cURLを起動し、必要に応じて次の表で定義された1つ以上のコマンドライン・オプションを指定して、その実行を指示します。
cURLオプション | 説明 |
---|---|
-d, --data @file.json |
ローカル・マシン上のJSON形式のリクエスト本文を含むファイルを識別します。 または、-d"{id=5,status='OK'} を使用してリクエスト本文を渡すことができます。 |
-F, --form @file.json |
ローカル・マシン上のフォーム・データをJSON形式で識別します。 |
-H --header, -I -include, and -X --request <method> |
次のいずれかまたは両方を定義します:
|
-i |
レスポンス・ヘッダー情報を表示します。 |
-u, --user <username>:<password> |
Address, Email, and Phone Verificationアカウントのユーザー名とパスワードを指定します。 |
-X |
リクエストのタイプ(GET、POSTなど)を示します。 |
たとえば:
curl -i -X GET -u <username>:<password> -H <request-header>:<value> https://<subdomain>.<domain>.com/<path>/<resource-path>