Skip to main content

Библиотека для интеграции с биржой микрозадач unu.im

Project description

UNU_API

Библиотека для интеграции с биржой микрозадач https://unu.im

Содержание

Как работает UNU?

  • Регистрируетесь на сайте
  • Добавляете задание и оплачиваете необходимое количество работ
  • Получаете результат и проверяете выполненные работы

Доступные типы задач

This is an image

  • Наполнение сайтов: комментарии, отзывы, форумы, доски объявлений
  • Продвижение в социальных сетях: подписчики в группы, лайки, репосты
  • Продвижение приложений: установки и действия
  • Любые произвольные задачи, которые нужно выполнять на регулярной основе

Установка

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

unu_api-0.2.4.tar.gz (8.4 kB view hashes)

Uploaded source

Built Distribution

unu_api-0.2.4-py3-none-any.whl (7.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page