Stamps python SDK
Project description
# Stamps API
This is a Python library to interact with Stamps API
(https://stamps.co.id/api). It depends on Python requests library.
## Basic Usage
```python
import stamps
client = stamps.Client(token="ABCDEFGHIJKLMN")
# add transaction
merchant_id = 1
store_id = 1
user_email = "random @ email.com"
total_value = 50000
invoice_number = "invoice-1"
created = "2013-02-15T13:01:01+07"
items = [
{"product_name": "Ice tea", "quantity": 1, "price": 15000},
{"product_name": "Fried Rice", "quantity": 1, "price": 35000},
]
client.transactions.add(merchant_id, store_id, user_email,
total_value, invoice_number, created=created,
items=items)
```
## Handling error
```python
# Inspired by https://stripe.com/docs/api?lang=python#errors
import stamps
client = stamps.Client(token="ABCDEFGHIJKLMN")
try:
response_dict = client.authentication.login("steven@ui.co.id", "correct-password")
except stamps.exceptions.InvalidRequestException as e:
# Submitted request is invalid, check error
print(e.http_status)
print(e.error_messages)
# Access the underlying Response object
print(e.response)
except stamps.exceptions.AuthenticationException as e:
# Your token is wrong
pass
except stamps.exceptions.ConnectionException as e:
# HTTP request failed, network trouble
pass
except stamps.exceptions.StampsException as e:
# There's something wrong from stamps API end point
pass
except Exception as e:
# Something else happened, unrelated to Stamps API
pass
```
## Development
```
pip install -e .
pip install responses tox
# to test
tox
```
This is a Python library to interact with Stamps API
(https://stamps.co.id/api). It depends on Python requests library.
## Basic Usage
```python
import stamps
client = stamps.Client(token="ABCDEFGHIJKLMN")
# add transaction
merchant_id = 1
store_id = 1
user_email = "random @ email.com"
total_value = 50000
invoice_number = "invoice-1"
created = "2013-02-15T13:01:01+07"
items = [
{"product_name": "Ice tea", "quantity": 1, "price": 15000},
{"product_name": "Fried Rice", "quantity": 1, "price": 35000},
]
client.transactions.add(merchant_id, store_id, user_email,
total_value, invoice_number, created=created,
items=items)
```
## Handling error
```python
# Inspired by https://stripe.com/docs/api?lang=python#errors
import stamps
client = stamps.Client(token="ABCDEFGHIJKLMN")
try:
response_dict = client.authentication.login("steven@ui.co.id", "correct-password")
except stamps.exceptions.InvalidRequestException as e:
# Submitted request is invalid, check error
print(e.http_status)
print(e.error_messages)
# Access the underlying Response object
print(e.response)
except stamps.exceptions.AuthenticationException as e:
# Your token is wrong
pass
except stamps.exceptions.ConnectionException as e:
# HTTP request failed, network trouble
pass
except stamps.exceptions.StampsException as e:
# There's something wrong from stamps API end point
pass
except Exception as e:
# Something else happened, unrelated to Stamps API
pass
```
## Development
```
pip install -e .
pip install responses tox
# to test
tox
```
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
stamps-python-0.0.3.tar.gz
(4.1 kB
view hashes)
Built Distribution
Close
Hashes for stamps_python-0.0.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b1095d59ddfb6c597428ae8a40dc3c1becda9ff4e2c0043f1325050045b43f2e |
|
MD5 | 1288c7f0b49c703b5b7ab5cf05e11ab5 |
|
BLAKE2b-256 | 73f390100b98c20e9bf2fdcbd844862f7f26a82f003963e89666c255e214d0f7 |