HTTP REST client, simplified for Python
|Travis Badge| |Code Climate|
Quickly and easily access any RESTful or RESTful-like API.
If you are looking for the SendGrid API client library, please see this
repo <https://github.com/sendgrid/sendgrid-python>
__.
All updates to this project is documented in our
CHANGELOG <https://github.com/sendgrid/python-http-client/blob/master/CHANGELOG.md>
__.
.. code:: bash
pip install python_http_client
or
.. code:: bash
easy_install python_http_client
Here is a quick example:
GET /your/api/{param}/call
.. code:: python
import python_http_client
global_headers = {"Authorization": "Basic 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.
.. code:: python
import python_http_client
global_headers = {"Authorization": "Basic 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
Example
Code <https://github.com/sendgrid/python-http-client/tree/master/examples>
__If you are intersted in the future direction of this project, please
take a look at our
milestones <https://github.com/sendgrid/python-http-client/milestones>
__.
We would love to hear your feedback.
We encourage contribution to our projects, please see our
CONTRIBUTING <https://github.com/sendgrid/python-http-client/blob/master/CONTRIBUTING.md>
__
guide for details.
Quick links:
Feature
Request <https://github.com/sendgrid/python-http-client/blob/master/CONTRIBUTING.md#feature_request>
__Bug
Reports <https://github.com/sendgrid/python-http-client/blob/master/CONTRIBUTING.md#submit_a_bug_report>
__Sign the CLA to Create a Pull
Request <https://github.com/sendgrid/python-http-client/blob/master/CONTRIBUTING.md#cla>
__Improvements to the
Codebase <https://github.com/sendgrid/python-http-client/blob/master/CONTRIBUTING.mdimprovements_to_the_codebase>
__We were inspired by the work done on
birdy <https://github.com/inueni/birdy>
_ and
universalclient <https://github.com/dgreisen/universalclient>
_.
python-http-client is guided and supported by the SendGrid Developer
Experience Team <mailto:[email protected]>
__.
python-http-client is maintained and funded by SendGrid, Inc. The names and logos for python-http-client are trademarks of SendGrid, Inc.
|SendGrid Logo|
.. |SendGrid Logo| image:: https://uiux.s3.amazonaws.com/2016-logos/email-logo%402x.png :target: https://www.sendgrid.com
.. |Travis Badge| image:: https://travis-ci.org/sendgrid/python-http-client.svg?branch=master :target: https://travis-ci.org/sendgrid/python-http-client .. |Code Climate| image:: https://codeclimate.com/github/sendgrid/python-http-client/badges/gpa.svg :target: https://codeclimate.com/github/sendgrid/python-http-client