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
API I used returns token inside response header, there was no way to access it, so I've managed to prepare two more functions. One for full access to raw response, and the second to fetch specific header value in simplest possible way. I have no time to prepare full test suites, but it should work on any environments.
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
You need to have the ESP8266 board support already installed.
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);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.
All methods return an HTTP status code or 0 if there was an error.
Start making requests!
get(const char* path, [String* response]);Examples:
int statusCode = client.get("/");String response = "";
int statusCode = client.get("/", &response);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(const char* path, const char* body);
put(const char* path, String* response);
put(const char* path, const char* body, String* response);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);// Get raw response (without body)
getRawLastResponse();
// Get response header value by key
getResponseHeader(const char* key, String*);Examples:
String rawResponse = client.getRawLastResponse();
String headerValue;
client.getResponseHeader("Token", &headerValue);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
If you're having trouble, you can always open RestClient.cpp and throw at the top:
#define HTTP_DEBUGEverything happening in the client will get printed to the Serial port.
ricardochimal For all his c++ help. Couldn't have done this without you!
theycallmeswift Helping incept and debug v1.0