AID Public API Для разработчиков

Публичный API для интеграции с платформой AID: профиль, кошелёк, рефералы и VPN-ключи. Все запросы отправляются на базовый адрес:

Base URL https://aidapp.in/api/
Формат
JSON
Доступ
API-ключ
Лимит
60 / мин
Авторизация

Все запросы требуют API-ключа. Ключ можно получить в разделе Профиль → Ключ для интеграций.

Заголовок рекомендуется
Authorization: Bearer sk_live_ваш_ключ
Query-параметр менее безопасно
?api_key=sk_live_ваш_ключ
Формат ответа

Все ответы приходят в JSON. Признак ошибки — поле error.

Успешный ответ
{
  "error": false,
  "data": { ... }
}
Ошибка
{
  "error": true,
  "message": "Описание ошибки"
}
Аккаунт и кошелёк

Владелец ключа, баланс и история операций.

GET/me

Информация о текущем пользователе — владельце ключа.

Параметры

Без параметров.

Ответ
{
  "error": false,
  "data": {
    "aid_id": "42678",
    "telegram_id": "5564446233",
    "email": "user@example.com",
    "first_name": "Иван",
    "last_name": "Иванов",
    "username": "ivanov"
  }
}
Пример
curl https://aidapp.in/api/me \
  -H "Authorization: Bearer sk_live_..."
GET/balance

Текущий баланс кошелька.

Параметры

Без параметров.

Ответ
{
  "error": false,
  "data": {
    "balance": 1500.50
  }
}
Пример
curl https://aidapp.in/api/balance \
  -H "Authorization: Bearer sk_live_..."
GET/transactions

История транзакций пользователя.

Параметры query
ПараметрТипОписание
limitintКоличество записей (1–100)По умолчанию: 50
offsetintСмещение для пагинацииПо умолчанию: 0
Ответ
{
  "error": false,
  "data": {
    "transactions": [
      {
        "id": "12345",
        "type": "credit",
        "amount": "500.00",
        "description": "Пополнение",
        "service_code": "topup",
        "created_at": "2026-03-01 12:00:00"
      }
    ]
  }
}
Типы транзакций
typeОписание
creditПополнение
debitСписание (покупка)
ref_rewardРеферальное вознаграждение
withdraw_holdУдержание для вывода
withdraw_releaseВыплата
withdraw_revertВозврат удержания
Пример
curl "https://aidapp.in/api/transactions?limit=20&offset=0" \
  -H "Authorization: Bearer sk_live_..."
Рефералы

Статистика, список приглашённых и реферальные коды.

GET/referrals/count

Сводная статистика реферальной программы.

Параметры

Без параметров.

Ответ
{
  "error": false,
  "data": {
    "total": 147,
    "paid": 25,
    "earnings_month": 1240.50,
    "earnings_year": 9870.00
  }
}
Пример
curl https://aidapp.in/api/referrals/count \
  -H "Authorization: Bearer sk_live_..."
GET/referrals/list

Список рефералов: имя, дата регистрации, код привлечения и заработок с каждого.

Параметры query
ПараметрТипОписание
limitintКоличество записей (1–200)По умолчанию: 50
offsetintСмещение для пагинацииПо умолчанию: 0
sortstringearnings, date или nameПо умолчанию: earnings
searchstringПоиск по имени и фамилии
ref_codestringФильтр по коду. _no_code — пришедшие без кода
Ответ
{
  "error": false,
  "data": {
    "referrals": [
      {
        "aid_id": 540324,
        "user_id": 618096981,
        "first_name": "Дарья",
        "last_name": "",
        "avatar": null,
        "reg_date": 1788879971,
        "ref_code": "414595496",
        "total_earned": 128.40
      }
    ],
    "total": 147,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

aid_id — идентификатор аккаунта, он есть всегда. user_id — Telegram ID, у зарегистрировавшихся через сайт его нет и приходит null. Опирайтесь на aid_id.

Пример
curl "https://aidapp.in/api/referrals/list?limit=50&sort=date" \
  -H "Authorization: Bearer sk_live_..."
GET/referrals/paid

Рефералы с оплаченными активными VPN ключами.

Параметры

Без параметров.

Ответ
{
  "error": false,
  "data": {
    "paid_referrals": [
      {
        "aid_id": 493638,
        "first_name": "Дарья",
        "last_name": "",
        "username": "dasha",
        "avatar": null,
        "ref_code": "414595496",
        "ref_since": "2026-05-12 10:31:00",
        "protocol": "vless",
        "period_days": 30,
        "clients_count": 2,
        "price_paid": 234.00,
        "remaining_money": 78.20,
        "key_status": "active",
        "key_expires_at": "2026-10-12 10:31:00"
      }
    ]
  }
}

ref_code — код, по которому пришёл реферал. У привлечённых до появления кодов он null.

Пример
curl https://aidapp.in/api/referrals/paid \
  -H "Authorization: Bearer sk_live_..."
GET/referrals/codes

Список ваших реферальных кодов.

Параметры

Без параметров.

Ответ
{
  "error": false,
  "data": {
    "codes": [
      {
        "code": "5564446233",
        "code_type": "numeric",
        "is_default": "1",
        "is_deletable": "0",
        "created_at": "2026-01-15 10:00:00"
      },
      {
        "code": "mycode",
        "code_type": "custom",
        "is_default": "0",
        "is_deletable": "1",
        "created_at": "2026-02-10 15:30:00"
      }
    ]
  }
}
Пример
curl https://aidapp.in/api/referrals/codes \
  -H "Authorization: Bearer sk_live_..."
POST/referrals/codes

Создать новый реферальный код. Лимит — 100 кодов на пользователя.

Тело запроса JSON
ПараметрТипОписание
codestringВаш код (a-z, 0-9, _, -, 3–24 символа). Если пусто — сгенерируется случайный.
Ответ
{
  "error": false,
  "data": { ... }
}
Пример
curl -X POST https://aidapp.in/api/referrals/codes \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"code": "my_promo"}'
POST/referrals/codes/delete

Удалить реферальный код (только если is_deletable=1).

Тело запроса JSON
ПараметрТипОписание
codestringКод для удаления
Ответ
{
  "error": false,
  "data": { ... }
}
Пример
curl -X POST https://aidapp.in/api/referrals/codes/delete \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"code": "my_promo"}'
VPN

Работа со своими VPN ключами: перевыпуск и отвязка устройств. Чужие ключи недоступны — владелец определяется по API-ключу.

GET/vpn/keys

Ваши VPN ключи. Нужен, чтобы узнать key_id для остальных запросов. Ссылки подписки и учётные данные здесь не отдаются.

Параметры

Без параметров.

Ответ
{
  "error": false,
  "data": {
    "keys": [
      {
        "key_id": 108016,
        "name": null,
        "protocol": "vless",
        "addons": ["whitelist2"],
        "clients_count": 2,
        "status": "active",
        "created_at": 1788879971,
        "expires_at": 1796655971
      }
    ]
  }
}

expires_at и created_at — unix-время. Сколько осталось, считается как expires_at - now.

Пример
curl https://aidapp.in/api/vpn/keys \
  -H "Authorization: Bearer sk_live_..."
GET/vpn/devices

Устройства, привязанные к ключу.

Параметры query
ПараметрТипОписание
key_idintИдентификатор ключа из /vpn/keys
Ответ
{
  "error": false,
  "data": {
    "devices": [
      {
        "hwid": "k53ele6emx2t7j5d",
        "userId": 90978,
        "platform": "iOS",
        "osVersion": "26.5",
        "deviceModel": "iPhone 17 Pro",
        "userAgent": "Happ/5.9.0/ios/2609171647606",
        "requestIp": "185.209.15.75",
        "createdAt": "2026-09-08T15:06:58.936Z",
        "updatedAt": "2026-09-08T15:07:15.387Z"
      }
    ],
    "total": 1
  }
}
Пример
curl "https://aidapp.in/api/vpn/devices?key_id=108016" \
  -H "Authorization: Bearer sk_live_..."
POST/vpn/keys/reissue

Перевыпуск ключа: выдаётся новая ссылка подписки, старая перестаёт работать, все привязки устройств сбрасываются. Ссылку придётся заново добавить в клиент.

Тело запроса JSON
ПараметрТипОписание
key_idintИдентификатор ключа
Ответ
{
  "error": false,
  "data": { ... }
}
Пример
curl -X POST https://aidapp.in/api/vpn/keys/reissue \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"key_id": 108016}'

Перевыпуск прокси-ключа ждёт применения настроек на панели и может занять около минуты.

POST/vpn/devices/disconnect

Отвязать одно устройство от ключа. Освобождает место под лимитом; само устройство сможет подключиться заново.

Тело запроса JSON
ПараметрТипОписание
key_idintИдентификатор ключа
hwidstringИдентификатор устройства из /vpn/devices
Ответ

Список устройств, оставшихся у ключа, в том же формате, что у /vpn/devices.

{
  "error": false,
  "data": {
    "devices": [ ... ],
    "total": 1
  }
}
Пример
curl -X POST https://aidapp.in/api/vpn/devices/disconnect \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"key_id": 108016, "hwid": "k53ele6emx2t7j5d"}'
POST/vpn/devices/disconnect-all

Отвязать все устройства от ключа разом.

Тело запроса JSON
ПараметрТипОписание
key_idintИдентификатор ключа
Ответ
{
  "error": false,
  "data": { ... }
}
Пример
curl -X POST https://aidapp.in/api/vpn/devices/disconnect-all \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"key_id": 108016}'
Ограничения
60 запросов в минутуМаксимум на один API-ключ
Один ключ на пользователяКлюч привязан к одному пользователю; при перевыпуске старый ключ удаляется
Ключ — только вашНе передавайте ключ третьим лицам
Список всех эндпоинтов

Также доступен программно — возвращает JSON со списком всех доступных маршрутов, авторизация не требуется:

GET https://aidapp.in/api/