RestClient for Arduino ESP8266 WiFi modules

HTTP Request library for Arduino and the ESP8266 WiFi SOC modules

This library supports SSL!
To use with SSL either include the SHA1 fingerprint of the certificate of the site you are connecting to, or force the library to use ssl insecurely (don't veryify the server is who it says it is).

You can get the SHA1 fingerprint by using a desktop browser and inspecting the SSL cert used at the site. Please note: this is FRAGILE, if the site updates their SSL, your code will break. But, there is not enough memory on the ESP8266 to store all the rool certs, so this is a working method. Se the example below.

This library is derived almost entirely from the great work done here: https://github.com/csquared/arduino-restclient

Install

Clone (or download and unzip) the repository to ~/Documents/Arduino/libraries where ~/Documents/Arduino is your sketchbook directory.

> cd ~/Documents/Arduino
> mkdir libraries
> cd libraries
> git clone https://github.com/dakaz/esp8266-restclient.git RestClient

Dependencies

You need to have the ESP8266 board support already installed.

Usage

Constructor to create an RestClient object to make requests against.

RestClient(const char* host/ip, [int port], [bool force / const char* fingerprint]);

Use a domain name and default to port 80:

RestClient client = RestClient("esp-rest-test.herokuapp.com");

Use a local IP and an explicit port:

RestClient client = RestClient("192.168.1.50", 5000);

Use a domain name, an explicit port to an SSL site and verify the certificate with its fingerprint:

RestClient client = RestClient("www.kudoso.com", 443, "EE 16 77 79 55 58 92 46 FB 18 40 99 2E 17 7E AB 32 0A 4A 88");

Use a domain name, an explicit port to an SSL site and force insecure SSL with no certificate verification:

RestClient client = RestClient("www.kudoso.com", 443, 1);

dhcp()

Sets up EthernetClient with a mac address of DEADBEEFFEED. Returns true or false to indicate if setting up DHCP was successful or not. Not used on the ESP.

RESTful methods

All methods return an HTTP status code or 0 if there was an error.

Start making requests!

GET

get(const char* path, [String* response]);

Examples:

int statusCode = client.get("/");

String response = "";
int statusCode = client.get("/", &response);

POST

There are three different overloads of post:

post(const char* path, const char* body);
post(const char* path, String* response);
post(const char* path, const char* body, String* response);

Examples:

String response = "";
int statusCode = client.post("/", &response);

const char* post_body = "{foo: 'bar', bob: 'alice'}";

int statusCode = client.post("/", post_body);

String response = "";
const char* post_body = "{foo: 'bar', bob: 'alice'}";

int statusCode = client.post("/", post_body, &response);

PUT

put(const char* path, const char* body);
put(const char* path, String* response);
put(const char* path, const char* body, String* response);

DEL

del(const char* path);
del(const char* path, const char* body);
del(const char* path, String* response);
del(const char* path, const char* body, String* response);

Full Example

I test every way of calling the library (against a public heroku app)[https://github.com/csquared/arduino-http-test].

You can find the file in File->Examples->RestClient->full_test_suite

Debug Mode

If you're having trouble, you can always open RestClient.cpp and throw at the top:

#define HTTP_DEBUG

Everything happening in the client will get printed to the Serial port.

Thanks

ricardochimal For all his c++ help. Couldn't have done this without you!

theycallmeswift Helping incept and debug v1.0