HTTPRequest is a single-header library for making HTTP requests. You can just include it in your project and use it. HTTPRequest was tested on macOS, Windows and GNU/Linux, but it should work on most of the Linux-based platforms. Supports IPv4 and IPv6.
Example of GET request
#include "HTTPRequest.hpp"
try
{
// you can pass http::InternetProtocol::V6 to Request to make an IPv6 request
http::Request request{"http://test.com/test"};
// send a get request
const auto response = request.send("GET");
std::cout << std::string{response.body.begin(), response.body.end()} << '\n'; // print the result
}
catch (const std::exception& e)
{
std::cerr << "Request failed, error: " << e.what() << '\n';
}
Example of POST request
#include "HTTPRequest.hpp"
try
{
http::Request request{"http://test.com/test"};
// send a post request
const auto response = request.send("POST", "foo=1&bar=baz", {
"Content-Type: application/x-www-form-urlencoded"
});
std::cout << std::string{response.body.begin(), response.body.end()} << '\n'; // print the result
}
catch (const std::exception& e)
{
std::cerr << "Request failed, error: " << e.what() << '\n';
}
Example of POST request by passing a map of parameters
#include "HTTPRequest.hpp"
try
{
http::Request request("http://test.com/test");
// pass parameters as a map
std::map<std::string, std::string> parameters = {{"foo", "1"}, {"bar", "baz"}};
const auto response = request.send("POST", parameters, {
"Content-Type: application/x-www-form-urlencoded"
});
std::cout << std::string{response.body.begin(), response.body.end()} << '\n'; // print the result
}
catch (const std::exception& e)
{
std::cerr << "Request failed, error: " << e.what() << '\n';
}
To set a timeout for HTTP requests, pass std::chrono::duration
as a last parameter to send()
. A negative duration (default) passed to send()
disables timeout.
HTTPRequest is released to the Public Domain.