Features Overview¶

The restcl library provides a modern, clean, header-only C++ interface for executing HTTP requests against RESTful endpoints.

Key Features¶

Literal OperatorsJSON API MetaphorAsynchronous & Callback SupportNative Platform Performance

Construct HTTP requests directly from string literals using expressive suffixes like _GET, _POST, _PUT, and _DELETE.

auto req = "https://api.example.com/items"_GET;

First-class integration with nlohmann::json. Requests and responses structure headers, parameters, and content body seamlessly as JSON objects.

req.setContent({ {"key", "value"}, {"count", 42} });

Execute requests synchronously or asynchronously using non-blocking I/O with callback functions.

client->sendAsync(std::move(req), [](auto& req, auto resp) {
    // Handle response
});

Zero overhead wrapper over native system HTTP engines: - Windows: WinHTTP (WinHttpRESTClient) - Unix/Linux/macOS: libcurl (HttpRESTClient)

Summary Matrix¶

Feature	Description	Reference
User-Defined Literals	Suffix syntax (`"url"_GET`) for concise request creation	Literals
JSON Payload Handling	Built-in serialization with `nlohmann::json`	JSON Metaphor
Async Callbacks	Non-blocking execution using `sendAsync`	Async Operations
Cross-Platform Factory	Unified `GetRESTClient()` creation	GetRESTClient