# HTTP リクエスト構文の調査

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

このセクションでは、HTTP リクエストの形式について説明します。 HTTP リクエストの送信や HTTP レスポンスの表示について詳しくは、 [HTTP クライアント](http-client-in-product-code-editor.html) を参照してください。

CLion コードエディターで HTTP リクエストを作成するには、次の一般的な構文を使用してください：

```HTTP_REQUEST_FULL
Method Request-URI HTTP-Version
Header-field: Header-value

Request-Body

```

Procedure: HTTP リクエストでコメントを使用する

* リクエスト内で、  `//`  または  `#`  で任意の行を開始して、コメント行にします。

```HTTP_REQUEST_FULL
// A basic request
GET http://example.com/a/

```

Procedure: HTTP リクエストの名前を設定する

[run/debug configurations](http-client-in-product-code-editor.html#http-request-run-debug-configurations)、 [Search Everywhere](searching-everywhere.html)、 [Run Anything](running-anything.html#send_http_requests) でリクエストをすばやく見つけるために、名前を付けられます。

* リクエストの上にある  `###`  、  `# @name`  、  `# @name =`  の横に名前を入力します。

![HTTP リクエスト名を入力する](https://resources.jetbrains.com/help/img/idea/2026.3/aqua_http_request_name.png)

リクエストに名前がない場合、CLion はリクエストファイル内での位置（  `#1`  など）をリクエスト名として使用します。 リクエストファイルに同じ名前のリクエストが複数含まれている場合、CLion はそれぞれの名前にリクエスト位置番号を追加します。 これにより、各リクエスト名が一意になり、   サービス   ツールウィンドウ、実行 / デバッグ構成などで必要なものを簡単に見つけることができます。

![サービスツールウィンドウの HTTP リクエスト](https://resources.jetbrains.com/help/img/idea/2026.3/aqua_http_request_same_names.png)

Procedure: GET リクエストに短い形式を使用する

* GET  要求の場合、要求メソッドを省略して URI のみを指定できます。

```HTTP_REQUEST_FULL
// A basic request
https://example.com/a/

```

Procedure: 単一のファイルで複数のリクエストを作成する

1. リクエストの終わりには、  `###`  セパレータをその下に入力します。

```HTTP_REQUEST_FULL
// A basic request
https://example.com/a/

###

```

2. セパレータの下に別のリクエストを作成します。

```HTTP_REQUEST_FULL
// A basic request
https://example.com/a/

###

// A second request using the GET method
https://example.com:8080/api/html/get?id=123&value=content

```

Procedure: 実行遅延を設定する

* `sleep(ms)`  関数を使用すると、HTTP リクエストまたはスクリプトの実行を、指定したミリ秒数だけ一時停止できます。 これは、各種接続テスト、WebSocket テストなどに特に役立ちます。

`sleep()`  関数と  `await`  キーワードを組み合わせて使用して実行を一時停止します:  `await sleep(milliseconds)`

* スクリプトの残りの部分をブロックせずに、遅延後にコードの一部を実行するようにスケジュールしたい場合は、 [Web API メソッド](https://developer.mozilla.org/en-US/docs/Web/API/Window)を使用します。

* [setTimeout()](https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout) : 指定されたミリ秒数後に一度だけ実行される関数をスケジュールします。 タイマー ID を返します。

* [clearTimeout()](https://developer.mozilla.org/en-US/docs/Web/API/Window/clearTimeout) : `setTimeout()` で設定されたタイムアウトをキャンセルします。 タイマー ID を受け付けます。

* プリリクエストスクリプトでは、HTTP リクエストの実際の送信を遅延させることができます。 レスポンスハンドラーでは、受信したレスポンス後のテスト実行やロジックを遅延させるための関数を使用します。

```HTTP_REQUEST_FULL
< {%
    const job = setTimeout(() => {
        console.log("This timer is cleared and will not execute.");
    }, 1000);

    console.log("Pre-request: Starting sleep...");
    clearTimeout(job);

    const start = Date.now();
    await sleep(10000);

    console.log(`Pre-request: Finished sleep after ${Date.now() - start}ms`);
    console.log("Pre-request: Proceeding to request.");
%}

GET https://examples.http-client.intellij.net/anything

> {%
    setTimeout(() => {
        console.log("Post-script: One second timer fired during sleep.");
    }, 1000);

    console.log("Post-script: Starting sleep...");

    const start = Date.now();
    await sleep(10000);

    console.log(`Post-script: Finished sleep after ${Date.now() - start}ms`);
    console.log("Post-script: Script execution complete.");
%}
                
```

Procedure: 長いリクエストをいくつかの行に分割する

* 最初の行以外のすべてのクエリ文字列行をインデントします。

```HTTP_REQUEST_FULL
// Using line breaks with indent
GET http://example.com:8080
    /api
    /html
    /get
    ?id=123
    &value=content

```

> **Tip:**
> URL 部分のインデントサイズは  `設定 | エディター | コードスタイル | HTTP リクエスト | タブとインデント | URL 部分のインデント`  で構成されます。

* クエリ文字列が原因で URL が長すぎる場合は、専用のコンテキストアクションを使用して、各クエリパラメーターを新しい行に配置できます。 クエリ文字列部分にキャレットを置き、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) (   コンテキストアクションの表示   ) を押して、   クエリパラメーターを別々の行に配置   を選択します。

Before:

```HTTP_REQUEST_FULL
GET https://example.com:8080/api/get/html?firstname=John&lastname=Doe&planet=Tatooine&town=Freetown

```

After:

```HTTP_REQUEST_FULL
GET https://example.com:8080/api/get/html?
    firstname=John&
    lastname=Doe&
    planet=Tatooine&
    town=Freetown

```

> **Note:**
> `設定 | エディター | コードスタイル | HTTP リクエスト | 折り返しと波括弧 | クエリパラメーターのラップ`  の HTTP クライアントコードスタイルを使用して、クエリパラメーターの一貫したラッピングを強制できます。

* 同様に、  `Content-Type: application/x-www-form-urlencoded`  を使用してリクエストの本文をフォーマットできます。 キャレットを本文に置き、 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS)) (   コンテキストアクションの表示   ) を押して、   フォーム urlencoded パラメーターを別々の行に配置する   を選択します。

Before:

```HTTP_REQUEST_FULL
POST https://ijhttp-examples.jetbrains.com/post
Content-Type: application/x-www-form-urlencoded

key1=value1&key2=value2&key3=value3&key4=value4&key5=value5

```

After:

```HTTP_REQUEST_FULL
POST https://ijhttp-examples.jetbrains.com/post
Content-Type: application/x-www-form-urlencoded

key1 = value1 &
key2 = value2 &
key3 = value3 &
key4 = value4 &
key5 = value5

```

`x-www-form-urlencoded`  ボディのラッピングを構成するには、  `設定 | エディター | コードスタイル | HTTP リクエスト | 折り返しと波括弧 | フォーム URL でコード化されたパラメーターのラップ`  を使用します。  `=`  の前後および  `&`  の前にスペースを構成するには、  `設定 | エディター | コードスタイル | HTTP リクエスト | スペース`  を使用します。

Procedure: 認証を使用して Web サービスにアクセスする

* アクセスする Web サービスに応じて、 [基本(英語)](https://en.wikipedia.org/wiki/Basic_access_authentication)または [ダイジェスト (英語)](https://en.wikipedia.org/wiki/Digest_access_authentication)  許可 ヘッダーを指定します。

```HTTP_REQUEST_FULL
// Basic authentication
GET http://example.com
Authorization: Basic username password

###

// Digest authentication
GET http://example.com
Authorization: Digest username password

```

> **Note:**
> 他の HTTP 要求要素と同様に、提供された  `username`  および  `password`  は、 [環境変数](http-client-variables.html)によってパラメーター化できます。

Procedure: 要求メッセージ本文を提供する

リクエストの中で空白行を先頭に追加し、次のいずれかを実行します：

* リクエスト本文をその場で入力します：

```HTTP_REQUEST_FULL
// The request body is provided in place
POST https://example.com:8080/api/html/post HTTP/1.1
Content-Type: application/json
Cookie: key=first-value

{ "key" : "value", "list": [1, 2, 3] }

```

Content-Type  ヘッダーフィールドの値を [CLion でサポートされている言語](null) のいずれかに設定すると、対応する言語フラグメントが HTTP リクエストメッセージ本文に [自動挿入](using-language-injections.html) されます。  コンテンツタイプ が指定されていない場合は、言語フラグメントを手動で挿入できます。

* 要求本体をファイルから読み取るには、  `<`  シンボルの後にファイルのパスを入力します。

```GENERIC
// The request body is read from a file
POST https://example.com:8080/api/html/post
Content-Type: application/json

< ./input.json

```

Procedure: multipart/form-data コンテンツタイプを使用する

* 要求の  コンテンツタイプ を  マルチパート / フォームデータ に設定します。  マルチパート / フォームデータ メッセージの一部としてファイルを送信するには、  コンテンツ処理 ヘッダーに  `filename`  パラメーターを含めます。

```HTTP_REQUEST_FULL
POST https://example.com/api/upload HTTP/1.1
Content-Type: multipart/form-data; boundary=boundary

--boundary
Content-Disposition: form-data; name="first"; filename="input.txt"

// The 'input.txt' file will be uploaded
< ./input.txt

--boundary
Content-Disposition: form-data; name="second"; filename="input-second.txt"

// A temporary 'input-second.txt' file with the 'Text' content will be created and uploaded
Text
--boundary
Content-Disposition: form-data; name="third";

// The 'input.txt' file contents will be sent as plain text.
< ./input.txt --boundary--

```

> **Tip:**
> multipart/form-data  リクエストを迅速に作成するには、   mptr   [ライブテンプレート](using-live-templates.html)を使用してください。

Procedure: 次のリダイレクトを無効にする

HTTP リクエストがリダイレクトされると（3xx ステータスコードが受信されると）、リダイレクトされたページの応答が返されます。   サービス   ツールウィンドウでは、リダイレクトされたページの応答と、要求中に発生したすべてのリダイレクトを表示できます。

次のリダイレクトを無効にすることをお勧めします。 この場合、実際のリダイレクト応答ヘッダー（301 または 302 など）が返されます。

* リクエストの前に、  `@no-redirect`  タグ付きのコメント行を追加します。

```HTTP_REQUEST_FULL
// @no-redirect
example.com/status/301

```

すでにリダイレクトされたリクエストがある場合は、   サービス   ツールウィンドウの  `Redirections`  リストの横にある   無効化   をクリックできます。 これにより、  `@no-redirect`  タグが最初のリクエストに追加されます。

![リダイレクトを伴う HTTP レスポンス](https://resources.jetbrains.com/help/img/idea/2026.3/aqua_http_response_redirect.png)

Procedure: リクエスト履歴へのリクエストの保存を無効にする

必要に応じて、 [リクエストをリクエスト履歴](http-client-in-product-code-editor.html#requests_history)に保存しないようにすることができます。 これは、リクエストに機密データが含まれていて、ログに記録したくない場合に役立ちます。

* リクエストの前に、  `@no-log`  タグ付きのコメント行を追加します。

```HTTP_REQUEST_FULL
// @no-log
GET example.com/api

```

Procedure: 受信した Cookie の Cookie への保存を無効にする jar

[必要に応じて、受信した Cookie が Cookie jar](http-client-in-product-code-editor.html#manage_cookies) に保存されないようにすることができます。 このようにして、  `http-client.cookies`  ファイルから不要な Cookie を手動で削除することを回避できます。

* リクエストの前に、  `@no-cookie-jar`  タグ付きのコメント行を追加します。

```HTTP_REQUEST_FULL
// @no-cookie-jar
GET example.com/api

```

Procedure: エンコードを無効にする

デフォルトでは、HTTP クライアントはリクエストパラメーターとボディを ASCII 形式にエンコードします。 例: リクエストパラメーター内のスラッシュ文字は  `%2F`  として送信されます。 エンコードを無効にして、リクエストをそのまま送信することもできます。

* リクエストの前に、  `@no-auto-encoding`  タグ付きのコメント行を追加します。

エンコーディングが無効:

タグを使用すると、リクエストパラメーターと本文はエンコードされません。

```HTTP_REQUEST_FULL
# @no-auto-encoding
GET https://examples.com/api?
            name=@#$somebody&
            qwerty=%40%23%24

```

結果のリクエストは変更されずに送信されます。

```HTTP_REQUEST_FULL
https://examples.com/api?name=@#$somebody&qwerty=%40%23%24

```

エンコーディングが有効化:

タグが使用されていない場合、エンコードはデフォルトで有効になります。

```HTTP_REQUEST_FULL
### Default behavior
GET https://examples.com/api?
            name=@#$somebody&
            qwerty=%40%23%24

```

このリクエストでは、パラメーターがエンコードされます。

```HTTP_REQUEST_FULL
https://examples.com/api?name=%40%23%24somebody&qwerty=%40%23%24

```

Procedure: HTTP リクエストのタイムアウトをカスタマイズする

HTTP クライアントには、サーバーとの接続を確立するための 60 秒のタイムアウトと、進行中の接続で新しいパケットを待機するための別の 60 秒のタイムアウトがあります。 これらのタイムアウトは両方ともカスタマイズできます。

* 確立された接続で新しいパケットのタイムアウトを設定するには、リクエストの前に  `@timeout`  タグを含むコメント行を追加します。

```HTTP_REQUEST_FULL
# @timeout 600
GET example.com/api

```

* 接続タイムアウトを設定するには、リクエストの前に  `@connection-timeout`  タグを含むコメント行を追加します。

```HTTP_REQUEST_FULL
// @connection-timeout 2 m
GET example.com/api

```

デフォルトでは、タイムアウト値は秒単位ですが、値の後に明示的な時間単位を追加できます。ミリ秒の場合は  `ms` 、秒の場合は  `s` 、分の場合は  `m` 、たとえば  `100 ms`  または  `5 m` 。

> **Note:**
> VM オプション (  `ヘルプ | カスタム VM オプションの編集`  ) を使用して、IDE レベルでこれらのタイムアウトを変更することもできます。
>
>
>
> * `-Didea.connection.timeout` は接続タイムアウト (デフォルトではミリ秒単位) を構成します。 個々の HTTP 要求では、 `@connection-timeout` 属性によってそれが上書きされます。
>
> * `-Didea.read.timeout` は、新しいパケットのタイムアウトを設定します (デフォルトではミリ秒単位)。 個々の HTTP 要求では、 `@timeout` 属性によってそれが上書きされます。
>
>
>
> VM オプションがアプリケーション全体の CLion の動作に影響することに注意してください。 これらのタイムアウトは、HTTP クライアントを使用して行う HTTP リクエストだけでなく、CLion がネットワークとやり取りする際（外部サービスにアクセスする場合など）に送信するすべての HTTP リクエストにも適用されます。

## 応答を処理する

JavaScript を使用して応答を処理できます。 リクエストの後に  `>`  文字を入力し、JavaScript ファイルのパスと名前を指定するか、応答ハンドラーのスクリプトコードを  `{% ... %}`  でラップします。

```HTTP_REQUEST_FULL
GET https://httpbin.org/get

> /path/to/responseHandler.js

```

```HTTP_REQUEST_FULL
GET https://httpbin.org/get

> {%
    client.global.set("my_cookie", response.headers.valuesOf("Set-Cookie")[0]);
%}

```

詳細については、 [HTTP レスポンス処理 API リファレンス](http-response-handling-api-reference.html)を参照してください。

## 応答をリダイレクトする

応答をファイルにリダイレクトできます。  `>>`  を使用して、接尾辞がすでに存在する場合は新しいファイルを作成し、  `>>!`  を使用して、ファイルが存在する場合はファイルを書き換えます。 絶対パスまたは現在の HTTP リクエストファイルからの相対パスを指定できます。 また、環境変数や次の事前定義された変数など、パスで変数を使用することもできます。

* `{{$projectRoot}}` はプロジェクトのルートディレクトリを指します

* `{{$historyFolder}}` は `.idea/httpRequests/` を指します

次の HTTP 要求の例では、HTTP 要求ファイルの隣の  `myFolder`  に  `myFile.json`  を作成し、応答をそれにリダイレクトします。 ファイルがすでに存在する場合は、  `myFile-1.json`  が作成されます。

```HTTP_REQUEST
POST https://httpbin.org/post
Content-Type: application/json

{
  "id": 999,
  "value": "content"
}

>> myFolder/myFile.json
        
```

次の HTTP リクエストの例では、  `.idea/httpRequests/`  に  `myFile.json`  を作成します。 ファイルがすでに存在する場合は、ファイルを上書きします。 また、プロジェクトルートにある  `handler.js`  スクリプトを使用し [て応答を処理](#response-handling)します。

```HTTP_REQUEST
POST https://httpbin.org/post
Content-Type: application/json

{
  "id": 999,
  "value": "content"
}

> {{$projectRoot}}/handler.js

>>! {{$historyFolder}}/myFile.json
        
```

> **Note:**
> Windows の場合、円記号  `\`  を使用してパスを指定します。

