Для разработчиков
Aegis для ваших
интеграций.
API, SDK и MCP работают с вашим обычным аккаунтом. Начните с чтения статуса подписки — с правами, которые выбрали сами.
JavaScript / TypeScript · Go · MCP stdio · набор от 11.10.2026
Начните с одного разрешения.
Откройте свой аккаунт
Войдите в существующий кабинет. В разделе «Доступ» раскройте «Для разработчиков».
Создайте ключ для чтения
Выберите
account:readи нужный срок. Ключ принадлежит только вашему аккаунту. Секрет показывается один раз; его можно отозвать в том же разделе.Передайте ключ через секрет окружения
Задайте
AEGIS_API_KEYна своём сервере или через механизм секретов MCP-хоста. Храните ключ вне публичного кода, переписки и общих конфигураций.
Скачайте и распакуйте набор исходников по ссылке выше. Он содержит SDK, готовые примеры, OpenAPI и исходники MCP. Установка пакета из npm или получение нового кода из GitHub не требуются.
Проверить загруженный набор
Набор от 11.10.2026, редакция 1: 44 571 байт. В PowerShell вычислите SHA-256 скачанного файла и сравните с ожидаемым значением:
Get-FileHash .\aegis-developer-kit-20261011-r1.zip -Algorithm SHA256da1eba8ed86ac7c8b7a22577bfbac1383f68b521f12d0053a21c4c60cc2624adПрочитайте статус своего аккаунта.
Примеры выполняют один запрос и выводят только статус. Ключ и полный ответ в вывод не попадают.
JavaScript и TypeScript
Нужен Node.js 20 или новее. В каталоге распакованного набора, после настройки AEGIS_API_KEY, запустите готовый пример:
node examples/account.mjsКак устроен запрос
SDK подключается локальным ESM-импортом. Минимальный запрос по примеру из набора:
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.
Go
Набор содержит отдельный минимальный Go-модуль с SDK и готовым примером. Нужен Go 1.25 или новее; при первой сборке Go загрузит закреплённую зависимость google/uuid v1.6.0.
cd backend
go run ./examples/accountКак устроен запрос
Фрагмент examples/account/main.go; полный файл с импортами находится в наборе:
client, err := aegis.New(aegis.Config{
APIKey: os.Getenv("AEGIS_API_KEY"),
})
if err != nil { return err }
account, err := client.Account(ctx)
if err != nil { return err }
fmt.Println(account.Status)MCP только для чтения
В распакованном наборе перейдите в backend и соберите исполняемый файл для своей системы:
go build -o aegis-mcp.exe ./cmd/aegis-mcpНа macOS и Linux используйте имя aegis-mcp. Укажите полученный полный путь в настройках своего MCP-хоста и передайте ему AEGIS_API_KEY через механизм секретов.
{
"mcpServers": {
"aegis": {
"command": "C:/path/to/aegis-mcp.exe",
"env": {
"AEGIS_MCP_SCOPES": "account:read",
"AEGIS_MCP_ALLOW_MUTATIONS": "false"
}
}
}
}В шаблоне ключ не хранится: настройте его отдельно в секретах хоста. После подключения доступен aegis_account и локальный генератор UUID. Список инструментов ограничивает доступные вызовы, но не добавляет прав самому ключу.
Для чтения партнёрских сведений добавьте partners:read и в ключе, и в AEGIS_MCP_SCOPES. Оставьте AEGIS_MCP_ALLOW_MUTATIONS=false.
Права выбираете вы.
Для первого примера достаточно 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 и коды ответа. Наличие маршрута в контракте не означает, что возможность включена.
Ответы, лимиты и ошибки
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. О возможной уязвимости сообщите по тому же адресу.

