cURLの使用

cURLは、URL構文を含むデータを転送するためのオープン・ソースのコマンドライン・ツールであり、HTTPやHTTPSを含む各種のプロトコルをサポートしています。

このドキュメント内の例では、cURLを使用して、Database REST APIにアクセスする方法を示しています。

cURLを使用してREST APIにアクセスする手順は、次のとおりです。

  • 「クイック・スタート」の説明のようにcURLをインストールします。

  • コマンド・ウィンドウで、cURL環境変数CURL_CA_BUNDLEを、ローカルCA証明書バンドルの場所に設定します。cURLを使用したCA証明書の検証の詳細は、http://curl.haxx.se/docs/sslcerts.htmlを参照してください。

  • cURLを呼び出し、次の表に定義したコマンド行オプションを必要に応じて1つ以上指定してその実行を指示します

    cURLオプション 説明
    -d, --data @file.json ローカル・マシン上のJSON形式のリクエスト・ドキュメントを識別します。
    -F, --form @file.json ローカル・マシン上のJSON形式のフォーム・データを識別します。
    -H 次のいずれか、または両方を定義します。
    • リクエスト・ドキュメントのコンテンツ・タイプ

    • アイデンティティ・ドメインを識別するカスタム・ヘッダーX-ID-TENANT-NAME

    -i レスポンス・ヘッダー情報を表示します。
    -u, --user username:password <ProductName>アカウントのユーザー名とパスワードを指定します。
    -X リクエストの種類を指定します(GET、POSTなど)。

次に、cURLコマンドの構文の例を示します。

curl -i -X GET -u <username>:<password> -H <request-header>:<value> https://<subdomain>.<domain>.com/<path>/<resource-path>