cURLの使用
このドキュメント内の例では、cURLを使用して、トークン・サービスREST APIにアクセスする方法を示しています。
タスク1: cURLのインストール
このドキュメント内の例では、cURLコマンド行ツールを使用して、トークン・サービスREST APIにアクセスする方法を示しています。
サーバーに安全に接続するには、Verisign CA証明書に対して信頼できることを証明するSSL認証局(CA)の証明書ファイルまたはバンドルを備えたSSL対応バージョンのcURLをインストールする必要があります。認証の詳細は、「認証」を参照してください。
次の手順は、Windows 64?bitシステムへのcURLのインストール方法を示しています。
-
ブラウザで、cURLホーム・ページ(http://curl.haxx.se)に移動し、左のナビゲーション・メニューで「Download」をクリックします。
-
「cURL Releases and Downloads」ページで、使用しているオペレーティング・システムに対応したcURLソフトウェアのSSL対応バージョンを見つけ、ZIPファイルをダウンロードするリンクをクリックしてソフトウェアをインストールします。
-
「cURL CA Certs」ページ(http://curl.haxx.se/docs/caextract.html)にナビゲートし、cURLをインストールしたフォルダにca-bundle.crt SSL CA証明書バンドルをダウンロードします。
これで、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'} を使用してリクエスト本文を渡します。 |
-H --header, -I -include, and -X --request <method> |
次のいずれか、または両方を定義します。
|
-i |
レスポンス・ヘッダー情報を表示します。 |
-X |
リクエストの種類を指定します(GET、POSTなど)。 |
-k |
cURLを使用してセキュアでないSSL接続および転送を実行できるようにします。デフォルトでインストールされたCA証明書バンドルを使用して、すべてのSSL接続試行をセキュアにします。このため、-k/--insecure を使用しないと、すべてのセキュアでない接続は失敗します。 |
次に例を示します:
curl -i -X GET -u <username>:<password> -H <request-header>:<value> https://<subdomain>.<domain>.com/<path>/<resource-path>
cURLの詳細は、次のURLを参照してください: