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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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

Hashes for unu_api-0.2.4.tar.gz
Algorithm Hash digest
SHA256 734dbf292f137de03c3e967b6b9fb05047a27b490c291fe5137f53fd9c1f6043
MD5 2a4c98e430cb3c835b99203551f661d0
BLAKE2b-256 0b1c65f89f6eb0184cd06fa0714dfc10864f81ce47d81a2dad9ee01d033a4d91

See more details on using hashes here.

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

Hashes for unu_api-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 4269f79fa6e9a0df469ed2e37bcdd3453b4702a10ab386e3620e72844a997695
MD5 5e62585dbf2e9bb1c4abe43ff3cd17e5
BLAKE2b-256 2beb19619e48fa3861a417c1c7182ad6f396292e8f29711e70ed2477739b519d

See more details on using hashes here.

Supported by

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