README.md

curl-cpp-wrapper

A very simple HTTP client (C++ 11 wrapper for libcurl). Requires libcurl as dependency.

Usage

Just add NetworkClient.cpp and NetworkClient.h files to your project.

Do a GET request:

NetworkClient nc;
nc.doGet("http://google.com/?q=" + nc.urlEncode("Smelly cat"));
std::cout << nc.responseBody();

Do a POST request:

nc.setUrl("https://www.googleapis.com/oauth2/v3/token");
nc.addQueryParam("refresh_token", refreshToken); 
nc.addQueryParam("client_id", clientId); 
nc.addQueryParam("client_secret", clientSecret); 
nc.addQueryParam("grant_type", "refresh_token"); 
nc.doPost();
std::cout << nc.responseBody();

Do a POST request with RAW data:

nc.setUrl("https://www.googleapis.com/oauth2/v3/token");
nc.doPost("param1=value&param=value");

Downloading a file:

NetworkClient nc;
nc.setOutputFile("d:\\image.png"); // file path should be UTF-8 encoded on Windows
nc.doGet("http://i.imgur.com/DDf2wbJ.png");

Uploading a file:

#include "NetworkClient.h"
NetworkClient nc;
std::string fileName = "c:\\test\\file.txt"; // file path should be UTF-8 encoded on Windows
nc.setUrl("http://takebin.com/action");
nc.addQueryParamFile("file", fileName, "file.txt", "");
nc.addQueryParam("fileDesc", "cool file");

nc.doUploadMultipartData();
if ( nc.responseCode() == 200 )  {
    std::cout << nc.responseBody();
}

Do a PUT request:

nc.setMethod("PUT");
nc.setUrl("https://www.googleapis.com/drive/v2/files/" + id);
nc.addQueryHeader("Authorization", "Basic ...");
nc.addQueryHeader("Content-Type", "application/json");
std::string postData = "{\"title\" = \"SmellyCat.jpg\"}";
nc.doUpload("", postData);

Uploading a file to FTP:

std::string fileName = "c:\\test\\file.txt";  // file path should be UTF-8 encoded on Windows
nc.setUrl("ftp://example.com");
nc.setMethod("PUT");
nc.doUpload(fileName, "");

Using proxy:

nc.setProxy("127.0.0.1", "8888", CURLPROXY_HTTP); // CURLPROXY_HTTP, CURLPROXY_SOCKS4, CURLPROXY_SOCKS4A, CURLPROXY_SOCKS5, CURLPROXY_SOCKS5_HOSTNAME

Custom request header:

nc.addQueryHeader("Content-Type", "application/json");

Attention

You should build libcurl with Unicode feature enabled on Windows, otherwise, file upload may fail.

If you compile libcurl for Windows with OpenSSL support (instead of Schannel), you should put "curl-ca-bundle.crt" file into your application's binary directory).