Bounded HTTP client API; no HTTP server or HTTP/3. More...
Classes | |
| struct | Header |
| One header occurrence, preserving duplicates and received order. More... | |
| struct | Request |
| Fully buffered request. More... | |
| struct | Response |
| Fully buffered final response; informational responses are consumed, 3xx is returned unchanged, and body bytes are not decompressed. More... | |
| class | Receiver |
| Borrowed streaming consumer of the final response body. More... | |
| struct | Options |
| Scalar request limits. More... | |
| class | Client |
| Synchronous single-request-per-connection client. More... | |
Enumerations | |
| enum class | Error { InvalidURL , InvalidRequest , InvalidOptions , LimitExceeded , TimedOut , Cancelled , ResolverBusy , Transport , TLS , Protocol , Truncated , HTTP2 , Allocation , Rejected } |
| Typed terminal failures; no failed request is replayed. More... | |
| enum class | Protocol { Automatic , HTTP1 , HTTP2 } |
| Protocol selection. More... | |
|
strong |
Typed terminal failures; no failed request is replayed.
| Enumerator | |
|---|---|
| InvalidURL | Invalid or unsupported absolute URL. |
| InvalidRequest | Invalid method, field or unsupported request feature. |
| InvalidOptions | Invalid limits, deadline, protocol or moved-from client. |
| LimitExceeded | An explicit request/response bound was exceeded. |
| TimedOut | Total request deadline expired. |
| Cancelled | Borrowed cancellation flag was set. |
| ResolverBusy | Previous managed DNS work is still running. |
| Transport | DNS, connect or native I/O failed. |
| TLS | TLS configuration, authentication or engine failure. |
| Protocol | Invalid HTTP semantics, framing or required ALPN. |
| Truncated | Incomplete message or bare TCP EOF on authenticated TLS. |
| HTTP2 | HTTP/2 engine, frame, reset or GOAWAY failure. |
| Allocation | Provider-side allocation or callback construction failed. |
| Rejected | The streaming Receiver declined the response or failed. |
|
strong |
Protocol selection.
Automatic offers h2/http1.1 over HTTPS, and uses HTTP/1.1 for cleartext. HTTP2 requires h2 ALPN over HTTPS or uses explicit prior knowledge over cleartext, without fallback.
| Enumerator | |
|---|---|
| Automatic | HTTP/1 cleartext, h2/http1.1 HTTPS ALPN. |
| HTTP1 | HTTP/1.1 only. |
| HTTP2 | Required h2 ALPN or cleartext prior knowledge. |