Библиотека для интеграции с биржой микрозадач unu.im
Project description
UNU_API
Библиотека для интеграции с биржой микрозадач https://unu.im
Содержание
- Как работает UNU?
- Доступные типы задач
- Установка
- Зависимости
- Использование
- Тестирование
- Доступные методы
- Кастомные исключения
- Устранение неполадок
- Ссылки
Как работает UNU?
- Регистрируетесь на сайте
- Добавляете задание и оплачиваете необходимое количество работ
- Получаете результат и проверяете выполненные работы
Доступные типы задач
- Наполнение сайтов: комментарии, отзывы, форумы, доски объявлений
- Продвижение в социальных сетях: подписчики в группы, лайки, репосты
- Продвижение приложений: установки и действия
- Любые произвольные задачи, которые нужно выполнять на регулярной основе
Установка
pip install unu_api
Зависимости
На данный момент библиотека зависит только от requests
Использование
Получите токен в личном кабинете на сайте https://unu.im/api-info и инициализируйте класс для работы с API
from unu_api import Api
u = Api(token="ВАШ_ТОКЕН")
request = u.get_balance()
Тестирование
Протестировать библиотеку можно запустив команду pytest указав в переменной окружения ваш API_KEY
API_KEY=ВАШ_ТОКЕН pytest
Доступные методы
Реализован полный набор методов доступный в официальном API
- get_balance - Возвращает количество доступных средств
- get_folders - Возвращает все созданные папки с задачами
- create_folder - Создаёт новую папку
- move_task - Перемещает задачу в указанную папку
- get_tasks - Возвращает существующие задачи
- get_reports - Возвращает отчёты по определённой задаче или все существующие отчёты
- approve_report - Принимает (оплачивает) отчёт по заданию
- reject_report - Отклоняет отчёт по заданию
- get_expenses - Возврашает сумму израсходованных средств
- add_task - Создаёт новую задачу
- task_limit_add - Устанавливает лимит (добавляет выполнения) определённой задачи
- edit_task - Редактирует существующую задачу
- get_tariffs - Возвращает все доступные тарифы
- task_pause - Приостанавливает выполнение задачи
- task_play - Активирует выполнение задачи
- get_minter_wallet - Возвращает адрес Minter-кошелька для пополнения баланса аккаунта
Кастомные исключения
Мне пришлось реализовать кастомный набор ошибок для удобства разработки.
- AuthError - Исключение при отсутствие токена
- BalanceError - Исключения при отрицательном балансе
- RequestError - Исключение для неуспешных запросов к API
- JsonParsingError - Исключение для ошибок декодирования Json
- UnknowError - Для неизвестных ошибок
Устранение неполадок
Время от времени могут переставать работать определенные методы. Вместо json будет в ответ прилетать лог ошибки php, обычно я пишу в поддержку на сайте и разработчики фиксят эти баги. Для этого кейса я ввел кастомное исключение JsonParsingError.
Ссылки
Сайт биржи - https://unu.im
Блог автора - https://egorovegor.ru
Ссылка на GitHub - https://github.com/r4hx/unu_api/
Ссылка на PyPi - https://pypi.org/project/unu_api/
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
Built Distribution
File details
Details for the file unu_api-0.2.4.tar.gz
.
File metadata
- Download URL: unu_api-0.2.4.tar.gz
- Upload date:
- Size: 8.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.11 CPython/3.10.0 Darwin/21.1.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
734dbf292f137de03c3e967b6b9fb05047a27b490c291fe5137f53fd9c1f6043
|
|
MD5 |
2a4c98e430cb3c835b99203551f661d0
|
|
BLAKE2b-256 |
0b1c65f89f6eb0184cd06fa0714dfc10864f81ce47d81a2dad9ee01d033a4d91
|
File details
Details for the file unu_api-0.2.4-py3-none-any.whl
.
File metadata
- Download URL: unu_api-0.2.4-py3-none-any.whl
- Upload date:
- Size: 7.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.1.11 CPython/3.10.0 Darwin/21.1.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
4269f79fa6e9a0df469ed2e37bcdd3453b4702a10ab386e3620e72844a997695
|
|
MD5 |
5e62585dbf2e9bb1c4abe43ff3cd17e5
|
|
BLAKE2b-256 |
2beb19619e48fa3861a417c1c7182ad6f396292e8f29711e70ed2477739b519d
|