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

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

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

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

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": {
    "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"

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.