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

Введение

Skyline — вымышленная облачная платформа для управления приложениями, данными и инфраструктурой через единый программный интерфейс. Она сочетает REST API, командную строку и SDK, чтобы автоматизация не мешала разработке.

Запросы проходят через API Gateway, проверяются сервисом идентификации и направляются в управляющую плоскость. Рабочие узлы выполняют задачи, а события поступают в систему наблюдаемости.

Установка

Выберите привычный способ установки клиента Skyline. Для доступа к API нужен ключ проекта, который можно создать в консоли управления.

npm install -g @skyline/cli
skyline --version

python -m pip install skyline-sdk
python -c "import skyline; print(skyline.__version__)"

docker pull ghcr.io/skyline/cli:2
docker run --rm ghcr.io/skyline/cli:2 --version

brew tap skyline/tap
brew install skyline

Быстрый старт

Создайте проект, проверьте доступ и получите список доступных окружений. Ниже показан типичный рабочий процесс.

skyline login
skyline project create demo-app --region eu-central
skyline env list --project demo-app
skyline deploy ./dist --env production

CLI выводит идентификатор созданного ресурса и ссылку на журнал развёртывания. Команды безопасно повторять, если операция поддерживает идемпотентность.

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

Skyline поддерживает короткоживущие токены OAuth 2.0 для пользовательских приложений и ключи проекта для серверной автоматизации. Передавайте токен в заголовке Authorization, а не в URL.

curl https://api.skyline.example/v2/projects \
  -H "Authorization: Bearer $SKYLINE_TOKEN" \
  -H "Accept: application/json"

REST API

Базовый адрес API v2 — https://api.skyline.example/v2. Ответы представлены в JSON; время указывается в ISO 8601 UTC, а ресурсы имеют стабильные строковые идентификаторы.

Параметры запроса

Эндпоинты

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.skyline.example/v2/projects?limit=20"

{
  "name": "demo-app",
  "region": "eu-central",
  "labels": { "team": "platform" }
}

Песочница API

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

Командная строка (CLI)

CLI поддерживает интерактивную авторизацию, профили окружений и форматирование вывода. Добавляйте --output json для обработки результата скриптами.

skyline auth status
skyline config set region eu-central
skyline project list --output json
skyline logs tail deploy_01HXYZ --follow
skyline help deploy

Webhooks

Подписывайтесь на события deployment.succeeded, deployment.failed и project.updated. Skyline подписывает тело каждого события HMAC-SHA256; проверяйте подпись до обработки.

{
  "id": "evt_demo_82f1",
  "type": "deployment.succeeded",
  "created_at": "2026-10-15T12:30:00Z",
  "data": { "deployment_id": "dep_demo_01" }
}

SDK

Официальные библиотеки повторяют единый интерфейс клиента: настройте базовый URL и токен через переменные окружения, затем обрабатывайте ошибки API по их коду и HTTP-статусу.

import { Skyline } from "@skyline/sdk";

const client = new Skyline({
  token: process.env.SKYLINE_TOKEN
});
const projects = await client.projects.list();
console.log(projects.data);

Лимиты и обработка ошибок

Стандартный лимит составляет 600 запросов в минуту на проект. При ответе 429 Too Many Requests учитывайте заголовок Retry-After и используйте экспоненциальную задержку с небольшим случайным интервалом.

Частые вопросы

История изменений

Рабочее пространство

Перетаскивайте окна за заголовок, сворачивайте их на панель задач или разворачивайте на всю область. Содержимое можно редактировать прямо здесь.