README.md

REST client for C++

About

This is a simple REST client for C++. It wraps libcurl for HTTP requests.

Usage

I tried to keep usage close to the ruby rest-client. So the basic usage is:

RestClient::method(url, content-type, params);
// or
RestClient::method(url, content-type, params, headers);

Examples:

#include "restclient-cpp/restclient.h"

RestClient::response r = RestClient::get("http://url.com")
RestClient::response r = RestClient::post("http://url.com/post", "text/json", "{\"foo\": \"bla\"}")
RestClient::response r = RestClient::put("http://url.com/put", "text/json", "{\"foo\": \"bla\"}")
RestClient::response r = RestClient::del("http://url.com/delete")

// add some headers

RestClient::headermap headers;
headers["Accept"] = "application/json";

RestClient::response r = RestClient::get("http://url.com", headers)
RestClient::response r = RestClient::post("http://url.com/post", "text/json", "{\"foo\": \"bla\"}", headers)
RestClient::response r = RestClient::put("http://url.com/put", "text/json", "{\"foo\": \"bla\"}", headers)
RestClient::response r = RestClient::del("http://url.com/delete", headers)

The response is of type RestClient::response and has three attributes:

RestClient::response.code // HTTP response code
RestClient::response.body // HTTP response body
RestClient::response.headers // HTTP response headers

Dependencies

• libcurl

Installation

There are some packages available for Linux on packagecloud. Otherwise you can do the regular autotools dance:

./autogen.sh
./configure
make install

Contribute

All contributions are highly appreciated. This includes filing issues, updating documentation and writing code. Please take a look at the contributing guidelines before so your contribution can be merged as fast as possible.