# クライアント

Vapor のクライアント API では、外部のリソースに対して HTTP 通信を行うことができます。これは [async-http-client](https://github.com/swift-server/async-http-client) に基づいており、[コンテンツ](content.ja.md) API と統合されています。

## 概要

`Application` やルートハンドラー内の `Request` から、デフォルトクライアントにアクセスできます。

```swift
app.client // Client

app.get("test") { req in
	req.client // Client
}
```

アプリケーションのクライアントは、設定時に HTTP リクエストを送る際に便利です。ルートハンドラー内で HTTP リクエストを行う場合は、リクエストに紐づくクライアントを使うべきです。

### メソッド

`GET` リクエストを行う際には、目的の URL を `get` メソッドに渡します。

```swift
let response = try await req.client.get("https://httpbin.org/status/200")
```

`get`、`post`、`delete` など、各種 HTTP メソッドに対応したメソッドがあります。クライアントからのレスポンスは将来的に返され、HTTPステータス、ヘッダー、ボディが含まれます。

### コンテンツ

Vapor の [コンテンツ](content.ja.md) を使うと、クライアントリクエストやレスポンスのデータを扱うことができます。コンテンツやクエリパラメータをエンコードしたり、ヘッダーを追加するには、`beforeSend` クロージャを使います。

```swift
let response = try await req.client.post("https://httpbin.org/status/200") { req in
	// リクエストURLにクエリ文字列をエンコードします。
	try req.query.encode(["q": "test"])

	// JSONをリクエストボディにエンコードします。
    try req.content.encode(["hello": "world"])
    
	// リクエストに認証ヘッダーを追加します。
    let auth = BasicAuthorization(username: "something", password: "somethingelse")
    req.headers.basicAuthorization = auth
}
//レスポンスを扱う
```

レスポンスボディを `Content` を使ってデコードすることもできます。：

```swift
let response = try await req.client.get("https://httpbin.org/json")
let json = try response.content.decode(MyJSONResponse.self)
```

もし、futures を使っている場合は、`flatMapThrowing` を使うことができます。：

```swift
return req.client.get("https://httpbin.org/json").flatMapThrowing { res in
	try res.content.decode(MyJSONResponse.self)
}.flatMap { json in
	// Use JSON here
}
```

## 設定

アプリケーションを通じて、基本となる HTTP クライアントを設定することができます。

```swift
// Disable automatic redirect following.
app.http.client.configuration.redirectConfiguration = .disallow
```

初めてデフォルトクライアントを使用する前に、必ず設定を完了させておく必要があります。