5. Client API
All client-side functionality of Apache Pekko HTTP, for consuming HTTP-based services offered by other endpoints, is currently provided by the pekko-http-core
module.
It is recommended to first read the Implications of the streaming nature of Request/Response Entities section, as it explains the underlying full-stack streaming concepts, which may be unexpected when coming from a background with non-“streaming first” HTTP Clients.
All of the APIs deal with HttpRequest
and HttpResponse
objects.
Depending on your application’s specific needs you can choose from three different API levels:
- Request-Level Client-Side API
- for letting Apache Pekko HTTP perform all connection management. Recommended for most usages.
- Host-Level Client-Side API
- for letting Apache Pekko HTTP manage a connection-pool to one specific host/port endpoint. Recommended when the user can supply a
Source<HttpRequest, ?>
Source[HttpRequest, _]
with requests to run against a single host over multiple pooled connections. - Connection-Level Client-Side API
- for full control over when HTTP connections are opened/closed and how requests are scheduled across them. Only recommended for particular use cases.
You can interact with different API levels at the same time and, independently of which API level you choose, Apache Pekko HTTP will happily handle many thousand concurrent connections to a single or many different hosts.
- Configuration
- HttpRequest and HttpResponse
- Request-Level Client-Side API
- Host-Level Client-Side API
- Connection-Level Client-Side API
- Pool overflow and the max-open-requests setting
- Client-Side HTTPS Support
- Pluggable Client Transports / HTTP(S) proxy Support
- Client-Side WebSocket Support
- Client-Side HTTP/2 (Preview)