curl を使用する場合
curl を使用して、HTTP 応答を検査し、リソースをダウンロードするか、サーバーから API を呼び出します。トランスポートの成功とアプリケーションの成功を区別し、適切なタイムアウトを設定し、保存されたコマンド例に認証トークンが含まれないようにします。
構文
curl [PARAMETERS] URL角括弧はオプションの引数を示します。省略記号は繰り返しを意味します。ファイル名、ユーザー名、サーバー アドレスの例を独自の値に置き換えます。
共通のオプションと引数
使用例
サイトヘッダーを確認する
curl -I https://example.comヘッダーのみのリクエストが行われます。一部のサービスは、これを通常のコンテンツ要求とは異なる方法で処理します。
HTTP エラーの処理を含むファイルのダウンロード
curl --fail --location --output ./page.html https://example.comリダイレクトが続き、応答本文が指定されたローカル ファイルを置き換えます。 HTTP エラー ステータスは失敗の原因となります。
制限時間付きのリクエスト JSON
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusJSON 応答は、制限された全体期間で要求されます。エンドポイントは実際にその API を提供する必要があります。
注意事項と制限事項
- HTTPS では、証明書はデフォルトで検証されます。別途の理由がない限り、-k によるチェックを無効にしないでください。
- 実際のトークンやパスワードをコマンド履歴に保存したり、ダウンロードしたスクリプトを検証せずに実行したりしないでください。
よくある質問とトラブルシューティング
サーバーがエラー ページを返しても、curl が成功するのはなぜですか?
失敗オプションを使用しない場合でも、HTTP エラー応答を受信しても、転送は成功したと見なされます。 HTTP ステータスとコマンド終了ステータスの両方を検査します。
HTTPS を修正するには証明書の検証を無効にする必要がありますか?
日常的な修正として信頼をバイパスしないでください。代わりに、ホスト名、システム時刻、サーバー証明書チェーン、および信頼された CA 構成を確認してください。
さらにヘルプ
オプションはバージョンとディストリビューションによって異なります。次のコマンドを使用して、インストールされているドキュメントを確認します。 man curl.