Skip to content

Http

HTTP

class HTTP

HTTP(timeout=5000, ctx=())
Create an HTTP object by initializing http/https connection parameters according to the ctx sequence. The timeout, in milliseconds, is used for connections timeout.

The ctx sequence is composed as in the following:

  1. cacert: a bytearray for the Certification Authority certificate.
  2. clicert: a bytearray for the client certificate.
  3. clikey: a bytearray for the client private key.
  4. verify: a Bool that specifies whether the client has to be verified be the server or not.
  5. global: a Bool that specifies whether the global context has to be used or not.
  6. sec: a Bool that specifies whether to use hardware secure element or not.

method get

get(url, headers={})
Sends a GET request to the url with the optional header dictionary.

Returns a Response object with the server reply.

method post

post(url, headers={}, body="")
Sends a POST request to the url with the optional header dictionary and the body string containing the POST data.

Returns a Response object with the server reply.

method put

put(url, headers={}, body="")
Sends a PUT request to the url with the optional header dictionary and the body string containing the PUT data.

Returns a Response object with the server reply.

method patch

patch(url, headers={}, body="")
Sends a PATCH request to the url with the optional header dictionary and the body string containing the PATCH data.  Returns a Response object with the server reply.

method delete

delete(url, headers={}, body="")
Sends a DELETE request to the url with the optional header dictionary and the body string containing the DELETE data.  Returns a Response object with the server reply.

method head

head(url, headers={})
Sends a HEAD request to the url with the optional header dictionary.

Returns a Response object with the server reply.

method download

download(url, fd, headers={})
Sends a DOWNLOAD request to the url with the optional header dictionary and save the returning stream to fd file descriptor. If -1 is passed as fd the stream data is returned into the Response object.

Returns a Response object with the server reply.

method destroy

destroy()
Closes the http/https connection, de-initialize the configured connection and all resources freed.

class Response

Response(status, data, headers)
This class is used to contain HTTP methods responses. The class attributes are:

  • status is the HTTP return status from the server, as integer.
  • data stream data when available, as bytearray
  • headers is the set of HTTP headers associated to the request, as dictionary.