Документация разработчика

curl -X POST https://axionna.org/api/sponsors \
  -H "Authorization: Bearer AX-example-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 987654321,
    "max_sponsors": 3
  }'

import requests

url = "https://axionna.org/api/sponsors"
headers = {
    "Authorization": "Bearer AX-example-api-key",
    "Content-Type": "application/json"
}
payload = {
    "user_id": 987654321,
    "max_sponsors": 3
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const res = await fetch('https://axionna.org/api/sponsors', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer AX-example-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    user_id: 987654321,
    max_sponsors: 3
  })
});
const data = await res.json();
console.log(data);

curl -X POST https://axionna.org/api/check \
  -H "Authorization: Bearer AX-example-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 987654321,
    "task_ids": ["task_101", "task_102"]
  }'

# Пример проверки в боте с учётом защиты not_allowed
res = requests.post(
    "https://axionna.org/api/check",
    headers={"Authorization": "Bearer " + AXIONNA_API_KEY},
    json={"user_id": user_id, "task_ids": [item["id"] for item in tasks]}
).json()

for task in res.get("results", []):
    status = task.get("status")
    if status == "ok":
        # Успех (подписан на канал, запустил бота или перешел по ссылке)
        give_coins(user_id, 10)
    elif status == "not_allowed":
        # Фрод или не подошел под анкету: награду НЕ начисляем!
        print(f"Задание {task['id']}: не подходит (фрод/анкета)")
    else: # not_ok
        # Не выполнено: не подписан / не запустил
        print(f"Задание {task['id']}: не выполнено")

{
  "status": "ok",
  "all_subscribed": false,
  "results": [
    {
      "id": "task_101",
      "source": "internal",
      "link": "https://axionna.org/track/abc...",
      "status": "ok",
      "subscribed": true,
      "reward": "3.00",
      "credited": true,
      "error": null
    },
    {
      "id": "task_102",
      "source": "internal",
      "link": "https://axionna.org/track/xyz...",
      "status": "not_allowed",
      "subscribed": false,
      "reward": "0.00",
      "credited": false,
      "error": null
    }
  ]
}

curl -X POST https://axionna.org/api/views \
  -H "Authorization: Bearer AX-example-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 987654321,
    "greeting": false
  }'

res = requests.post(
    "https://axionna.org/api/views",
    headers={"Authorization": "Bearer " + AXIONNA_API_KEY},
    json={
        "chat_id": chat_id,
        "greeting": False
    }
).json()

if res.get("delivered"):
    print("Реклама успешно доставлена пользователю!")
else:
    print(f"Показ не состоялся, статус: {res.get('result')}")

{
  "status": "ok",
  "delivered": true,
  "reward_rub": "0.0350"
}

curl -X POST https://axionna.org/api/balance \
  -H "Authorization: Bearer AX-example-api-key" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "status": "ok",
  "balance": "1450.50",
  "total_earned": "3200.00",
  "total_spent": "1749.50",
  "bots_info": [
    {
      "bot_id": 123456,
      "bot_username": "my_bot",
      "revenue": 850.0
    }
  ]
}

from fastapi import FastAPI, Request

app = FastAPI()

@app.post("/webhook/axionna")
WEBHOOK_SECRET = "сохранённый_секрет"

@app.post("/webhook/axionna")
async def handle_unsub(req: Request):
    if req.headers.get("X-Axionna-Webhook-Secret") != WEBHOOK_SECRET:
        return {"ok": False}
    data = await req.json()
    if data.get("event") == "subscriber.unsubscribed":
        user_id = data["tg_user_id"]
        # Списание внутренней награды за досрочную отписку
        deduct_user_balance(user_id)
    return {"ok": True}

{
  "event": "subscriber.unsubscribed",
  "tg_user_id": 987654321,
  "chat_id": -100123456789,
  "status": "unsubscribed",
  "offer_link": "https://t.me/example"
}