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

Основные адреса

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

Для авторизации запросов передавайте ваш API key в параметре key (GET или POST). Получить ключ можно в личном кабинете.

GET / POST https://agdindex.com/api?key=YOUR_API_KEY&action=ACTION

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

Формат ответа

Успешные ответы возвращают status=success и поле data. Ошибки возвращают status=error и message. Для частично выполненного добавления ссылок возможен status=partial_error.

{
  "status": "success",
  "data": {}
}

{
  "status": "error",
  "message": "Error description"
}

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

action=stats GET

Возвращает Telegram ID, партнерский баланс и активные боты по движкам. Алиасы: check_balance

{
  "status": "success",
  "data": {
    "user_id": 5,
    "email": "[email protected]",
    "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://agdindex.com/api?key=YOUR_API_KEY&action=add_links" \
  -d "engine=google" \
  --data-urlencode "links=https://example.com/page-1"

Пример успешного ответа:

{
  "status": "success",
  "results": {
    "google": {
      "status": "success",
      "task_id": 4972,
      "urls": 2,
      "dispatch_status": "pending"
    }
  }
}

Ответ при нехватке баланса ботов (status: partial_error):

{
  "status": "partial_error",
  "results": {
    "google": {
      "status": "error",
      "code": "insufficient_bot_balance",
      "engine": "google",
      "required": 200,
      "available": 150,
      "missing": 50,
      "message": "Insufficient Google bot balance. 50 additional bots required."
    }
  }
}

action=check_status GET

Возвращает прогресс задачи, количество отправленных URL, статус отправки на ферму и завершение.

https://agdindex.com/api?key=YOUR_API_KEY&action=check_status&task_id=456

action=list_tasks GET

Возвращает список задач пользователя с пагинацией. По умолчанию limit=10, максимум limit=100.

https://agdindex.com/api?key=YOUR_API_KEY&action=list_tasks&page=1&limit=10

action=task_log GET

Возвращает лог выполнения задачи, если задача уже отправлена на ферму.

https://agdindex.com/api?key=YOUR_API_KEY&action=task_log&task_id=456

3. Платежи

action=payment_methods GET

Возвращает доступные способы оплаты, сети и кошельки. Алиасы: networks

action=create_payment POST

Создает счет на оплату выбранного тарифа.

action=check_payment GET

Проверяет статус счета. Для новых интеграций используйте invoice_id.

https://agdindex.com/api?key=YOUR_API_KEY&action=check_payment&invoice_id=inv_...

hash=inv_... поддерживается как устаревший алиас.

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

Партнерские методы доступны пользователям с валидным API key.

action=affiliate_stats GET

action=withdraw_affiliate POST

Создает заявку на вывод партнерского баланса. Минимальная сумма вывода — 10 USDT.