# Client

Vapor 的 client API 允许你使用 HTTP 调用外部资源，它基于 [async-http-client](https://github.com/swift-server/async-http-client) 构建，并集成了 [Content](content.zh.md) API。


## 概述

你可以通过 `Application` 或通过 `Request` 在路由处理回调中访问默认 `Client`。

```swift
app.client // Client

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


`Application` 的 `client` 对于在配置期间发起 HTTP 请求非常有用，如果要在路由处理程序中发起 HTTP 请求，请使用 `req.client`。


### 方法

如果你要发起一个 GET 请求，请将所需的 URL 地址传给 `client` 的 `get` 方法，如下所示：

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

HTTP 的常用方法（例如 `get`, `post`, `delete`）都有便捷的调用方式，Client 的响应会以一个 future 的形式返回，它包含了 HTTP 返回的状态、头部信息和内容。


### Content

Vapor 的 [Content](content.md) API 可用于处理客户请求和响应中的数据，如果要在请求体中添加参数或编码，请在 `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` 对 response body 解码采用熟悉的方式：
```swift
let response = try await req.client.get("https://httpbin.org/json")
let json = try response.content.decode(MyJSONResponse.self)
```

如果要解码响应的数据，请在 `flatMapThrowing` 回调中处理。

```swift
req.client.get("https://httpbin.org/json").flatMapThrowing { res in
    try res.content.decode(MyJSONResponse.self)
}.map { json in
    // 处理返回的JSON信息
}
```

## 配置

你可以通过 `application` 来配置 HTTP `client` 的基础参数。

```swift
// 禁止自动跳转
app.http.client.configuration.redirectConfiguration = .disallow
```

请注意，你必须在首次使用默认的 `client` 之前对其进行配置。