A wrapper to simplify using the libcurl for making REST API calls over a network.
This library uses libcurl.
The easiest way to get this working is via vcpkg:
git clone https://github.com/microsoft/vcpkg/
cd vcpkg
./bootstrap-vcpkg.bat
./vcpkg.exe install curl[ssl]:x64-windows
./vcpkg.exe integrate install
For all use cases, you'll want to create an instance of ofxCurl by calling
std::shared_ptr<Curl::HTTPClient> curl_instance = Curl::HTTPClient::make();
This creates an instance of cURL that will manage all network calls.
All requests are performed by starting with an HTTPRequest struct:
HTTPRequest new_request;
new_request.mMethod = HTTP_GET;
new_request.mUrl = "http://www.httpbin.org/get";
new_request.mParameterString = "";
For a simple blocking request, you would call makeRequest:
HTTPResponse response = curl_instance->makeRequest(new_request);
This will cause your program to wait for the call to be completed before storing the result in the HTTPResponse object.
Alternatively, you an utilize cURL's multithreaded multi-curl functionality by calling addRequest. To do this, you'll need to add a callback function to your request of the type std::function<void(HTTPResponse*)>:
Curl::HTTPRequest Get;
Get.mUrl = "http://www.httpbin.org/get";
Get.mMethod = Curl::HTTP_GET;
Get.mParameterString = mCurl->mapToString(requestParameters);
Get.mCallback = [=](Curl::HTTPResponse* response, Curl::HTTPClient* client) { std::printf("Request complete with response code %d; response was %s.\n", response->mResponseCode, response->mBody.c_str()); };
mCurl->addHTTPRequest(Get);
Your instance of ofxCurl will automatically handle loading the call when it has bandwidth available, making the request, and calling your callback function when it has completed the request.
This project uses the Git Flow paradigm. Before contributing, please make your own feature branch with your changes.