Документация API

Канонические пути

Совместимость

Старые .php маршруты остаются для существующих интеграций, но новые подключения должны использовать канонические пути.

/api.php /bot.php /docs ?fr=api ?fr=bot ?fr=api_docs

Аутентификация

Для API-запросов нужен пользовательский API key. Основной сценарий остается в Telegram, API нужен для автоматизации и больших объемов.

GET/POST https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=ACTION

POST используется для создания задач и платежей. GET используется для баланса, тарифов, движков и проверки статусов.

1. Аккаунт и тарифы

action=stats GET

{
  "status": "success",
  "data": {
    "telegram_id": 12345678,
    "affiliate_balance": 25.5,
    "active_bots": [
      { "typeb": "google", "total": "850" },
      { "typeb": "bing", "total": "200" }
    ]
  }
}

action=tariffs GET

{
  "status": "success",
  "data": {
    "google": [
      { "id": 1, "bots": 2000, "price": 10 },
      { "id": 2, "bots": 5000, "price": 24 }
    ],
    "bing": [
      { "id": 6, "bots": 2000, "price": 10 }
    ]
  }
}

action=engines GET

{
  "status": "success",
  "data": ["google", "bing", "openai"]
}

2. Ссылки и задачи

action=add_links POST

curl -X POST "https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=add_links" \
  -d "engine=google" \
  --data-urlencode "links=https://example.com/page-1"

action=check_status GET

https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=check_status&task_id=456

action=list_tasks GET

https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=list_tasks&page=1&limit=50

3. Платежи

action=payment_methods GET

Returns available payment methods and wallets.

action=create_payment POST

action=check_payment GET

https://botfarm.agdor.info/api?key=YOUR_API_KEY&action=check_payment&invoice_id=inv_...

hash=inv_... is still accepted as a legacy alias.

4. Партнерская программа

action=affiliate_stats GET

action=withdraw_affiliate POST

Affiliate endpoints are available to authenticated users with a valid API key.