MicroRESTCli is a micro HTTP JSON REST Web client based on MicroWebCli for MicroPython (used on ESP32 and Pycom modules)

Very easy to integrate and very light with 2 files only :

• "microRESTCli.py" - The REST client
• "microWebCli.py" - The base Web client (available here)

Simple but effective :

• Use it to requesting fastly HTTP JSON REST endpoints (Web APIs)
• Supports secured connections SSL/TLS over HTTP (https)
• Supports authentications HTTP Basic and Bearer Token
• Automatically bounces on HTTP(S) redirections (ressources moved)
• Adds helpers to convert datetime formats between timestamp and json
• Coulds save to a file the response content of any REST request

Using microRESTCli main class :

Name	Function
Constructor	rCli = MicroRESTCli(baseUrl, user=None, password=None, token=None)
Makes a GET request	rCli.GET(resUrl, fileToSave=None, progressCallback=None)
Makes a POST request	rCli.POST(resUrl, o, fileToSave=None, progressCallback=None)
Makes a PUT request	rCli.PUT(resUrl, o, fileToSave=None, progressCallback=None)
Makes a PATCH request	rCli.PATCH(resUrl, o, fileToSave=None, progressCallback=None)
Makes a DELETE request	rCli.DELETE(resUrl, fileToSave=None, progressCallback=None)
Gets status code of last call	rCli.GetLastStatusCode()
Gets status message of last call	rCli.GetLastStatusMessage()
Gets json response object of last call	rCli.GetLastJSONResponse()

Name	Property
Gets or sets the connection timeout in secondes	rCli.ConnTimeoutSec
Gets or sets the dict headers of http requests	rCli.Headers

Simple example :

from microRESTCli import MicroRESTCli

rCli = MicroRESTCli('https://my-web-api.io/rest', user='toto', password='blah123')

invoice = rCli.GET('invoice/%d' % 42)

try :
  u = { 'name':'geek', 'age':18 }
  resp = rCli.POST('user', u)
  print('User added')
except :
  err = rCli.GetLastJSONResponse()
  if err :
    print("%s API request failed (%s)" % (err.name, err.reason))

Example of saving response to a file :

from microRESTCli import MicroRESTCli

def progressCallback(microWebCli, progressSize, totalSize) :
  if totalSize :
    print('Progress: %d bytes of %d downloaded...' % (progressSize, totalSize))
  else :
    print('Progress: %d bytes downloaded...' % progressSize)

rCli        = MicroRESTCli('https://my-web-api.io/rest', token='jIud87jzIsUzj3=')
filename    = '/flash/invoice.pdf'
contentType = rCli.GET('invoice/%d/pdf' % 42, filename, progressCallback)
print('File of type "%s" saved to "%s"' % (contentType, filename))

Using microRESTCli helpers :

Name	Function
Converts timestamp to json datetime	MicroRESTCli.Timestamp2JsonDT(timestamp=None)
Converts json datetime to timestamp	MicroRESTCli.JsonDT2Timestamp(jsonDT)

By JC`zic for HC² ;')

Keep it simple, stupid 👍