4.1 KiB
Donation Alerts API Python
Модуль для Python, который позволит легко работать с Donation Alerts API
pip install donationalerts-api -U
Создать свое приложение Donation Alerts
Официальная документация Donation Alerts API
🔥 Простой пример работы
В этом примере мы логинимся в нашем приложении с определенными правами, получаем access_token, после в пременной user мы получаем JSON-объект, в котором содержится информация, в переменной donations тоже хранится информация, только уже другая. И теперь возвращаем нашу переменную user
DonationAlertsApi - основной класс для работы с DA API, на вход принимает client_id, client_secret, redirect_uri, scopes
Scopes - позволит вам передать ряд прав в удобном формате, все права можете посмотреть в оф. документации, также имеет атрибут ALL_SCOPES для передачи всех прав сразу (Scopes.ALL_SCOPES)
from flask import Flask, redirect, request
from donationalerts_api import DonationAlertsApi
from donationalerts_api.modules import Scopes
app = Flask(__name__)
api = DonationAlertsApi("client id", "client secret", "http://127.0.0.1:5000/login", [Scopes.USER_SHOW, Scopes.DONATION_INDEX])
@app.route("/", methods=["get"])
def index():
return redirect(api.login()) # Log in your application
@app.route("/login", methods=["get"])
def login():
code = request.args.get("code") # Получить нужный код для access token
access_token = api.get_access_token(code)
user = api.user(access_token)
donations = api.donations_list(access_token) # Получить список донатов
return user.objects # Возвращает JSON object
if __name__ == "__main__":
app.run(debug=True)
💖 Получение донатов в реальном времени без Oauth2
Здесь мы легко можем получить донат в реальном времени, для этого всего лишь нужно токен и пару строчек кода. Токен вы можете скопировать в Основных настройках. Теперь при новом донате, вы получите JSON-объект, который можете использовать уже сами.
from donationalerts_api import Alert
alert = Alert("token")
@alert.event()
def new_donation(event):
""" Пример обращения
event.username - получает никнейм донатера
event.objects - вернуть JSON object
"""
print(event) # Выведет все доступные атрибуты, к которым можно обратиться
Все примеры вы можете посмотреть в папке Examples
Donation Alerts API Python - небольшой обзор - в ролике, автор рассказывает о первой версии, возможно кому-то будет интересно
Donation Alerts API Python - получение событий в реальном времени - небольшая история обновлений и демонстрация новых возможностей