Перейти к содержимому

Infrastructure API

Один API, чтобы управлять проектами.

Плоскость /platform/v1 управляет вашими проектами, участниками, потребителями, устройствами, биллингом, доменами и SSO. Создайте проект, выпустите привязанный к нему ключ API и сделайте первый авторизованный вызов за минуты.

Плоскость /platform/v1

Всё, что нужно вашей интеграции.

Проекты и участники

Создавайте проекты, приглашайте участников и назначайте роли. Каждый запрос привязан к одному проекту.

Потребители и устройства

Заводите конечных пользователей вашего продукта и устройства, с которых они подключаются.

Биллинг

Тарифы, подписки, способы оплаты и права доступа — по каталогу вашего проекта.

Домены

Добавляйте и подтверждайте собственные домены для поверхностей вашего проекта.

SSO

Подключайте единый вход по OIDC для вашей команды и ваших клиентов.

Ключи API

самообслуживание

Выпускайте, просматривайте, ротируйте и отзывайте привязанные к проекту ключи fvpn_ — самостоятельно, из консоли или через сам API.

От нуля до первого вызова

Создайте ключ, сделайте вызов.

  1. Создайте проект

    POST /platform/v1/projects — или выберите существующий проект в консоли.

  2. Выпустите ключ API

    POST /platform/v1/api-keys с меткой. Открытый секрет fvpn_v1_ возвращается ровно один раз — сохраните его сразу.

  3. Сделайте первый авторизованный вызов

    Передайте ключ как Bearer-токен в любой эндпоинт /platform/v1 — начните с GET /platform/v1/projects.

# 1. Mint a project-scoped key — the plaintext fvpn_v1_ secret is returned ONCE.
curl -X POST https://api.fvpn.net/platform/v1/api-keys \
  -H "Authorization: Bearer $FORESTVPN_TOKEN" \
  -H "X-Project-Id: $PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{"name":"ci"}'

# 2. First authenticated call — present the new key as a Bearer token.
curl https://api.fvpn.net/platform/v1/projects \
  -H "Authorization: Bearer fvpn_v1_…"

Один источник API, авторизация Bearer по привязанному к проекту ключу. Открытый секрет показывается один раз при создании или ротации — API больше никогда его не возвращает.

Читать справочник APIКлючи API в справочнике

Стройте на Infrastructure API.

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