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

Aegis для ваших
интеграций.

API, SDK и MCP работают с вашим обычным аккаунтом. Начните с чтения статуса подписки — с правами, которые выбрали сами.

JavaScript / TypeScript · Go · MCP stdio · набор от 11.10.2026

Начните с одного разрешения.

  1. Откройте свой аккаунт

    Войдите в существующий кабинет. В разделе «Доступ» раскройте «Для разработчиков».

  2. Создайте ключ для чтения

    Выберите account:read и нужный срок. Ключ принадлежит только вашему аккаунту. Секрет показывается один раз; его можно отозвать в том же разделе.

  3. Передайте ключ через секрет окружения

    Задайте AEGIS_API_KEY на своём сервере или через механизм секретов MCP-хоста. Храните ключ вне публичного кода, переписки и общих конфигураций.

Скачайте и распакуйте набор исходников по ссылке выше. Он содержит SDK, готовые примеры, OpenAPI и исходники MCP. Установка пакета из npm или получение нового кода из GitHub не требуются.

Проверить загруженный набор

Набор от 11.10.2026, редакция 1: 44 571 байт. В PowerShell вычислите SHA-256 скачанного файла и сравните с ожидаемым значением:

Windows / PowerShell
Get-FileHash .\aegis-developer-kit-20261011-r1.zip -Algorithm SHA256
Ожидаемый SHA-256
da1eba8ed86ac7c8b7a22577bfbac1383f68b521f12d0053a21c4c60cc2624ad

Прочитайте статус своего аккаунта.

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

JavaScript и TypeScript

Нужен Node.js 20 или новее. В каталоге распакованного набора, после настройки AEGIS_API_KEY, запустите готовый пример:

Команда запуска
node examples/account.mjs
Как устроен запрос

SDK подключается локальным ESM-импортом. Минимальный запрос по примеру из набора:

JavaScript
import { AegisClient } from '../js/index.mjs';

const client = new AegisClient({
  apiKey: process.env.AEGIS_API_KEY,
});
const account = await client.account();
console.log(account.status);

В готовом файле также есть обработка ошибок с безопасными code и status. TypeScript declarations находятся рядом с SDK.

Права выбираете вы.

Для первого примера достаточно account:read. Остальные разрешения добавляйте под конкретную задачу.

account:read

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

partners:read

Баланс, условия, продажи, запросы выплат и результат своей операции. Текущий партнёрский режим — read_only.

Другие разрешения в контракте
devices:read / devices:revoke
Список и отзыв своих устройств. Эти сценарии не входили в production-проверку SDK от 11.10.2026.
partners:write
Участие и управление предложением. Новые операции выключены в текущем read_only.
payouts:request / subscription:credit
Запрос выплаты и продление из вознаграждения. Сейчас выключены; выдача scope сама по себе не включает эти возможности.

Ключи действуют от 1 до 90 дней; в кабинете можно выбрать 7, 30 или 90. Допускается до 10 одновременно действующих ключей. Scoped key не может выпускать или отзывать другие ключи.

Один API. Явный контракт.

Адрес API — https://edge.vpnaegis.com. SDK используют HTTPS, отказываются от перенаправлений и передают scoped key в Bearer-заголовке. Вход и выпуск ключа остаются в вашем кабинете.

OpenAPI · 0.1.0

HTTP-маршруты, схемы данных, scopes и коды ответа. Наличие маршрута в контракте не означает, что возможность включена.

Скачать JSON
Ответы, лимиты и ошибки

SDK по умолчанию ждут до 25 секунд, включая тело ответа, и ограничивают его размер 1 MiB. JS позволяет задать срок до 60 секунд; Go принимает настройки HTTP-клиента.

У чтений общий бюджет 120 запросов в минуту; у операций входа и изменений — 10. Бюджеты разделяются с другими маршрутами аккаунта и ограничиваются на сервере по источнику запроса. При 429 учитывайте Retry-After.

  • 401 unauthorized — ключ не подходит, просрочен, отозван или не имеет нужного scope.
  • 409 module_read_only — новая партнёрская операция выключена текущим режимом.
  • 409 idempotency_conflict — UUID уже связан с другим запросом.
  • 503 temporarily_unavailable — ответ не получен в штатном порядке; результат изменения может быть неопределённым.

SDK возвращают безопасные code и status вместо исходного ответа провайдера. Не записывайте ключи или полные ответы API в журнал.

Если позже понадобятся изменения

Вводное руководство использует только чтение. Для партнёрских изменений нужны соответствующий scope, действующий режим, принятые условия и UUID, сохранённый с исходным запросом до отправки.

SDK и MCP не повторяют mutation автоматически. После таймаута проверьте operation(uuid) с тем же UUID; не заменяйте его новым. not_found после неопределённого ответа само по себе не разрешает новое действие.

Подтверждённый запрос выплаты означает принятую заявку и резерв баланса, а не перевод в сети. SDK и MCP не отправляют криптовалюту. Автоматические выплаты и заказы серверов здесь не включаются.

Что проверено и где проходит граница

11.10.2026 реальные JavaScript SDK, Go SDK и MCP прошли чтение собственных временных аккаунтов через RF HTTPS API: девять сценариев, включая недостаточные права, отзыв и заданное истечение ключа. Тестовые записи удалены; прежние аккаунты и партнёрский учёт сохранены.

Проверка использовала пустые списки продаж и выплат и не доказывает фильтрацию непустой истории. Дата истечения была задана тестовому ключу; естественное ожидание срока не проверялось. Типизированные ответы Go и MCP не доказывают отсутствие неизвестных полей в исходном HTTP-ответе. Устройства, финансовые операции, нативные приложения и запуск из Telegram в этот прогон не входили.

SDK 0.1.0 распространяется в исходниках. Пакет не опубликован в npm; стабильность всех будущих версий API и сроки миграции пока не обещаются. Бизнес-данные и проверка ключей остаются на российском крае; статическая документация не принимает ваши секреты.

Нужна помощь с интеграцией?

Укажите язык, метод SDK и безопасный код ошибки. В сообщение не добавляйте ключ, код доступа или полный ответ API. О возможной уязвимости сообщите по тому же адресу.

Написать в поддержку