gleam/httpc

Types

Configuration

opaque </>

Configuration that can be used to send HTTP requests.

To be used with dispatch and dispatch_bits.

pub opaque type Configuration

ConnectError

</>

pub type ConnectError {
  Posix(code: String)
  TlsAlert(code: String, detail: String)
}

Constructors

```
Posix(code: String)
```
```
TlsAlert(code: String, detail: String)
```

HttpError

</>

pub type HttpError {
  InvalidUtf8Response
  FailedToConnect(ip4: ConnectError, ip6: ConnectError)
}

Constructors

```
InvalidUtf8Response
```

FailedToConnect(ip4: ConnectError, ip6: ConnectError)

Functions

configure

</>

pub fn configure() -> Configuration

Create a new configuration with the default settings.

dispatch

</>

pub fn dispatch(
  config: Configuration,
  request: Request(String),
) -> Result(Response(String), HttpError)

Send a HTTP request of unicode data.

dispatch_bits

</>

pub fn dispatch_bits(
  config: Configuration,
  req: Request(BitArray),
) -> Result(Response(BitArray), HttpError)

Send a HTTP request of binary data.

send

</>

pub fn send(
  req: Request(String),
) -> Result(Response(String), HttpError)

Send a HTTP request of unicode data using the default configuration.

If you wish to use some other configuration use dispatch instead.

send_bits

</>

pub fn send_bits(
  req: Request(BitArray),
) -> Result(Response(BitArray), HttpError)

Send a HTTP request of binary data using the default configuration.

If you wish to use some other configuration use dispatch_bits instead.

verify_tls

</>

pub fn verify_tls(
  config: Configuration,
  which: Bool,
) -> Configuration

Set whether to verify the TLS certificate of the server.

This defaults to True, meaning that the TLS certificate will be verified unless you call this function with False.

Setting this to False can make your application vulnerable to man-in-the-middle attacks and other security risks. Do not do this unless you are sure and you understand the risks.