Skip to content
Documentation

HAKOM.Http.Core.Net.Api Namespace

Contains the public API surface for building and configuring HAKOM HTTP services.

The central type in this namespace is Service, an abstract base class that orchestrates Kestrel configuration, dependency injection, logging, compression, CORS, proxy header forwarding and SSL certificate loading. Derive from it to create a new HTTP service with minimal boiler-plate.

For services that require strongly-typed settings read from configuration, use the generic Service<TSettingsClass,TSettingsInterface> variant instead.

Settings interfaces such as IHostingSettings, ICorsSettings, ICompressionSettings and IProxySettings define the configuration model and expose static TryRead factory methods together with sensible Defaults.

IServiceInformation provides metadata (title and description) about the running service, typically sourced from the hosting assembly’s attributes.

IConfigurationSection section = configuration.GetSection("MyService:Http:Hosting");
IHostingSettings settings = IHostingSettings.TryRead(section).GetValueOrThrow();
Classes
Service Base class for HTTP services.
Service<TSettingsClass,TSettingsInterface> Base class for HAKOM HTTP services that require strongly-typed settings bound from configuration.
Interfaces
ICompressionSettings Defines settings that control HTTP request decompression and response compression for the service.
ICorsSettings Defines Cross-Origin Resource Sharing (CORS) settings for an HTTP service.
IDefaultAcceptHeader Provides the default Accept media type that should be applied to requests that arrive without one (or with an empty or whitespace-only Accept header).
IHealthCheckSettings Settings that control health check behavior of the service. As for now, these settings only contain ShutdownTimeout, which is used to configure the GracefulShutdown.
IHostingSettings Aggregates all hosting-related settings for an HTTP service including URLs, proxy, CORS and compression configuration.
IProxySettings Defines settings for operating an HTTP service behind a reverse proxy.
IServiceInformation Describes an HTTP API.
© 2026 Volue.Version v0.6.38017 November 2026