vapor-docs/3.0/docs/http/client.md

HTTP Client

HTTP Clients are often used to communicate with external APIs such as PayPal, Stripe or Mailgun.

Connecting

Connecting only requires a hostname and a boolean indicating if you want to use SSL. For almost every use case it is recommended to use SSL. If you're processing any sensitive data such as payments, emails and other personal data you will need to use SSL by setting it to true.

HTTP clients require an eventloop to run on. The EventLoop is described in the async concepts introduction.

// Future<HTTPClient>
 let client = try HTTPClient.connect(
    to: "example.com",
    ssl: true,
    on: eventLoop
 )

You can override the port by specifying a custom port using the following parameters:

// Future<HTTPClient>
 let client = try HTTPClient.connect(
    to: "localhost",
    port: 8080,
    ssl: false,
    on: eventLoop
 )

Sending Requests

From here, you can send Requests. You can only send one request at a time. Sending a request before a Response has been received has unpredictable consequences.

// Future<Response>
let response = client.flatMap(to: Response.self) { connectedClient in
  let request = Request(
    method: .get,
    uri: "https://example.com/"
  )

  return connectedClient.send(request: request)
}