sowerest 0.0.12

HTTP REST client, simplified for SeWeMail API

Quickly and easily access any RESTful or RESTful-like API.

If you are looking for the sowemail API client library, please see this repo.

Table of Contents

• Installation

• Quick Start

• Usage

• Roadmap

• Local Setup of the Project

• Troubleshooting

• Announcements

• Thanks

• About

• License

Installation

Prerequisites

• Python version 3.4+

Install Package

pip install sowerest

or

easy_install sowerest

API Key

Store your sowemail API key in a .env file.

cp .env_sample .env

Edit the .env file and add your API key.

Quick Start

Here is a quick example:

GET /your/api/{param}/call

import sowerest

global_headers = {"Authorization": "Bearer XXXXXXX"}
client = Client(host='base_url', request_headers=global_headers)
client.your.api._(param).call.get()
print(response.status_code)
print(response.headers)
print(response.body)

POST /your/api/{param}/call with headers, query parameters and a request body with versioning.

import sowerest

global_headers = {"Authorization": "Bearer XXXXXXX"}
client = Client(host='base_url', request_headers=global_headers)
query_params = {"hello":0, "world":1}
request_headers = {"X-Test": "test"}
data = {"some": 1, "awesome": 2, "data": 3}
response = client.your.api._(param).call.post(request_body=data,
                                              query_params=query_params,
                                              request_headers=request_headers)
print(response.status_code)
print(response.headers)
print(response.body)

Usage

• Example Code

Thanks

We were mainly inspired by the work done on python-http-client, birdy and universalclient.

License

The MIT License (MIT)