Tochka API v2 aka Cyclops API
Project description
Tochka API v2 aka Cyclops API Library for Python
Ставьте звезды, суки бесполезные! Мне от ваших 100 установок в первый день НИКАКОЙ ПОЛЬЗЫ
Unofficial Python Library for Tochka API
Неофициальная библиотека на Python для работы с АПИ Точка Банка (я его предпочитаю называть дрочка банком). Документация туть.
- Работает через JSONRPC.
- Может грузить документы.
Установка:
pip install tochka-cyclops-api
# Если текущая версия падает с ошибкой, установите предыдущую
pip install tochka-cyclops-api==X.X.X
Поддержка asyncio пока не планируется, но за звезду и донат в пару тысяч оперативно добавлю.
В эпоху Docker использовать версии Python, отличные от последних — моветон, поэтому поддержка более старых точно не планируется.
Использование:
from tochka_cyclops_api import ApiTochka, ApiError
api = ApiTochka(
base_url='<API_URL>',
sign_system='<SIGN_SYSTEM>',
sign_thumbprint='<SIGN_THUMBPRINT>',
pkey_data=open('/path/to/rsaprivkey.pem').read(),
)
# Вызов методов
try:
"""
Отправит запрос с таким телом:
{
"id": "0d6a26ea-84f0-4be2-9999-b46edc9b59b6",
"jsonrpc": "2.0",
"method": "identification_payment",
"params": {
"payment_id": "cyclops-b9eabfd7-eead-4940-a6b1-4654850664f5",
"owners":[{
"virtual_account": "859b645a-ebb8-4f91-8b05-b433c85dc662",
"amount": 1000
}]
}
}
* camelCase преобразуется в snake_case: identificationPayment,
IdentificationPayment и identification_payment равнозначны.
* Вместо именованных параметров можно передать словарь.
* Если словарь и именованные параметры передаются вместе, то они мержатся,
причем именованные параметры перезапишут элементы словаря.
Результат будет примерно таким:
{
"virtual_accounts": [{
"code": "859b645a-ebb8-4f91-8b05-b433c85dc662",
"cash": 1000
}]
}
"""
res = api.identificationPayment(payment_id="cyclops-b9eabfd7-eead-4940-a6b1-4654850664f5", owners=[{
"virtual_account": "859b645a-ebb8-4f91-8b05-b433c85dc662",
"amount": 1000
}])
# Вместо словаря при парсинге объектов используется AttrDict,
# который позволяет к полям обращаться как к атрибутам, а не только по индексу
print(rv.virtual_accounts[0])
except ApiError as ex:
if ex.code == '4411':
print('Аккаунт не найден')
...
rv = api.upload_document(
'beneficiary',
# можно передать любой объект, имеющий метод read, например, `requests.get('https://target/path/to/file.pdf')`,
# но тогда придется указать content_type
open('/path/to/offer.pdf', 'rb'),
beneficiary_id='...',
document_type='contract_offer',
# Эти параметры можно опустить, они сгенерируются автоматически
document_date='2023-11-12',
document_number='12345',
)
print(rv.document_id) # cyclops-231020230621590-98a669e2-859b-44ac-9831-4a964ac7e49b
Запуск тестов:
poetry run python -m unittest
Все мыслимые права защищены в натуре (с) 2023.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for tochka_cyclops_api-0.2.9-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 76c4034c51b7aeea7b4153406cfa965be2f4ac4cd0e2f5b43dffd577c7d3e78f |
|
MD5 | ccfa69d6d5185e14a6fc4dd8a75fa9cc |
|
BLAKE2b-256 | 2588eccd6c953993ac26b0ad58e574ae87ab38be9e76e6d53a42788d811a4532 |