/projects
GET список, POST создать, PATCH обновить тариф, DELETE удалить. Возвращает id, status и ссылку на консоль.
API · документация · v3.2
Разворачивайте серверы одной строкой кода
REST API Linklet — это полный контроль над инфраструктурой из вашего скрипта, CI/CD или внутренней панели. Создавайте проекты, тяните бэкапы, меняйте тарифы и ловите события через вебхуки. Всё типизировано, всё в JSON.
- REST + JSON
- Bearer-токены
- Webhooks из коробки
$ curl -X POST /v3/projects
→ авторизация… ok
→ резервирование 2 vCPU… ok
✔ создан проект prj_8f3a за 0,42 с
api.linklet.app/v3/projects/prj_8f3a
Тариф: Pro+25 XP
01 · Введение
Что умеет API Linklet
Один базовый URL, единый формат ответов и предсказуемые коды состояния. Базовый адрес: https://api.linklet.app/v3.
02 · Аутентификация
Токены и уровни доступа
Все запросы идут по HTTPS. В заголовке передаётся персональный токен. Есть два вида: полный (для CI) и ограниченный (для браузерных панелей).
$ curl https://api.linklet.app/v3/me
-H "Authorization: Bearer llk_live_9f3a…"
✔ роль: owner · проект: prj_8f3a
Срок действия30 дней
Тестовые токены (llk_test_…) живут в песочнице и не тратят реальные ресурсы. Полный токен можно отозвать в любой момент из панели безопасности.
03 · Эндпоинты
Методы и ресурсы
Типичный набор операций. Каждый ресурс поддерживает стандартные глаголы и пагинацию через cursor.
/domains
Привязка домена и запись DNS. Метод verify проверяет владение и выпускает SSL-сертификат.
/snapshots
Создание снапшота и восстановление. Поле restore_to задаёт, какой момент времени вернуть.
/billing
Текущий тариф, лимиты и история платежей. Метод upgrade меняет план без простоя.
/members
Приглашения и роли (owner, admin, deploy-only). Изменения логируются в аудите.
/logs
Журнал событий проекта с фильтрами по уровню и временному диапазону. Поддерживает экспорт в файл.
04 · Примеры кода
Запуск проекта в трёх языках
Один и тот же запрос на создание проекта. Выберите свой стек — остальное совпадает.
Python
requests.post("…/v3/projects", json={"plan":"pro","cpu":2,"ram":4}, headers=hdr). Ответ приходит за ~0,4 с.
Node.js
fetch с опцией method: "POST" и заголовком Authorization. Асинхронно, без лишних обёрток.
Go
http.NewRequest с json.Marshal тела. Типизированная структура ответа уже в репозитории SDK.
05 · SDK и библиотеки
Официальные клиенты
Обёртки снимают рутину: сериализация, ретраи и пагинация уже внутри. Все обновляются в тот же день, что и API.
Установка за одну команду
Библиотеки публикуются в официальных реестрах и обновляются вместе с API.
06 · Webhooks
События, которые приходят сами
Подключите URL — и получите уведомление о каждом значимом событии. Подпись проверяется по заголовку X-Linklet-Signature.
deploy.succeeded
Срабатывает после успешного развёртывания. В теле — id проекта, версия и время запуска.
alert.threshold
Когда нагрузка или ошибки пересекают порог. Помогает строить авто-масштабирование.
billing.invoice
Счёт выставлен или оплачен. Удобно синхронизировать с вашей бухгалтерией.
07 · Лимиты
Квоты и ограничения
Стабильность для всех — поэтому есть честные пороги. При превышении возвращается 429 с заголовком Retry-After.
600
запросов в минуту на токен
10 МБ
макс. размер тела запроса
50
проектов на один аккаунт (Pro)
30 дн
срок жизни персонального токена
Начните интеграцию
Песочница и тестовые токены — бесплатно
Создайте тестовый токен за минуту и пробуйте API без реальных затрат. Полная документация, примеры и чат разработчиков прилагаются.