HTTP API

API работает по HTTPS и обменивается JSON. Базовый адрес — https://api.deploylane-cloud.com/v1, каждому запросу нужен bearer-токен.

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

curl https://api.deploylane-cloud.com/v1/projects \
  -H "Authorization: Bearer $DEPLOYLANE_TOKEN"

Токен несёт области доступа, выданные при создании. Запрос вне области возвращает 403 с машиночитаемым полем reason.

Эндпоинты

Метод	Путь	Назначение
GET	/v1/projects	Проекты, доступные токену
GET	/v1/projects/{id}/builds	История сборок с пагинацией
POST	/v1/projects/{id}/builds	Запустить сборку по git-ссылке
GET	/v1/builds/{id}	Статус сборки и тайминги фаз
GET	/v1/builds/{id}/logs	Поток логов, chunked transfer
GET	/v1/environments	Окружения и обслуживаемые артефакты
POST	/v1/environments/{id}/promote	Назначить окружению артефакт
POST	/v1/environments/{id}/rollback	Вернуть предыдущий артефакт
GET	/v1/metrics/dora	DORA-метрики за период

Запуск сборки

curl -X POST https://api.deploylane-cloud.com/v1/projects/prj_8f21/builds \
  -H "Authorization: Bearer $DEPLOYLANE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ref":"refs/heads/main","environment":"production"}'

{
  "id": "bld_5c93ae10",
  "status": "queued",
  "environment": "production",
  "strategy": "blue-green",
  "created_at": "2026-07-24T09:11:42Z"
}

Коды ошибок

Код	Значение
400	Некорректное тело запроса или неизвестное поле
401	Токен отсутствует, истёк или отозван
403	Токену не хватает области доступа
404	Объект не существует или не виден этому токену
409	Сборка для этой ссылки уже выполняется
422	Пайплайн не проходит валидацию схемы
429	Превышен лимит запросов, учитывайте `Retry-After`

Вебхуки

Для проекта задаётся адрес доставки событий build.succeeded, build.failed, environment.promoted и environment.rolled_back. Тело подписывается HMAC-SHA256: подпись в заголовке X-DeployLane-Signature, метка времени в X-DeployLane-Timestamp. Отклоняйте доставки старше пяти минут. Неуспешные доставки повторяются с экспоненциальной задержкой до шести часов.