Python

• Пакет: botads-sdk (pip install botads-sdk)

• Исходники и примеры: sdks/python (репозиторий: https://gitlab.com/botads/sdks/python)

• Клиенты: BotadsClient, AsyncBotadsClient

• Вебхуки: verify_signature, parse_webhook_payload, WebhookPayload

Быстрый старт

from botads import BotadsClient

client = BotadsClient(base_url="https://api.botads.app", api_token="<api_token>")
code = client.create_code(bot_id="123456789", user_tg_id="799001234")
print(code.code, code.expires_in)

Асинхронный вариант

import asyncio
from botads import AsyncBotadsClient

async def main():
    client = AsyncBotadsClient(base_url="https://api.botads.app", api_token="<api_token>")
    code = await client.create_code(bot_id="123456789", user_tg_id="799001234")
    print(code.code)

asyncio.run(main())

Проверка вебхуков

from botads import verify_signature, parse_webhook_payload

def handle_event(body: bytes, signature: str, api_token: str):
    # signature должен быть в формате "sha256=<hex>" из заголовка X-Signature
    if not verify_signature(body, signature, api_token):
        raise ValueError("Invalid signature")

    payload = parse_webhook_payload(body)
    # payload.event -> "direct_link" или "rewarded"

Пример FastAPI обработчика:

from fastapi import FastAPI, Request, HTTPException
from botads import verify_signature, parse_webhook_payload

app = FastAPI()
API_TOKEN = "<api_token>"

@app.post("/webhook")
async def webhook(request: Request):
    body = await request.body()
    signature = request.headers.get("X-Signature", "")  # sha256=<hex>
    if not verify_signature(body, signature, API_TOKEN):
        raise HTTPException(status_code=401, detail="invalid signature")
    payload = parse_webhook_payload(body)
    return {"ok": True, "event": payload.event}

Полный пример FastAPI: sdks/python/examples/fastapi/main.py.