Разработчикам
API существует. Публичного справочника пока нет.
Всё на этой платформе (витрина, корзина, панель) уже работает через единый API. Чего мы не сделали, так это не опубликовали его: сегодня нет клиентских токенов и справочной документации, и мы предпочитаем сказать об этом прямо, а не продавать вам скриншот.
Сегодня
Как обстоят дела на самом деле прямо сейчас.
Витрина и панель уже работают на нашем собственном внутреннем API. Публикация означает документацию, выдачу токенов и обещания стабильности, которые мы сможем выполнить, а ничего из этого пока нет.
Чего пока нет: API-ключей, которые можно создать самостоятельно, опубликованного справочника со схемами и обещаний стабильности, ради которых стоит строить что-то на API. Пока мы не можем письменно закрепить правила версионирования и вывода из эксплуатации, мы не выдаём токены: API, который меняется у вас под ногами, хуже, чем отсутствие API.
Если вашему процессу уже сейчас нужно программное развёртывание, расскажите, что вы создаёте, через форму запроса. Интерес действительно влияет на порядок разработки, и ранний доступ начнётся с тех, кто спросил.
Планируемые возможности
Что будет охватывать публичный API.
Это возможности, которые уже есть во внутреннем API и которые откроет публичный. Запланировано значит запланировано: сегодня клиенты не могут вызвать ничего из этого.
- Жизненный цикл сервера
- Создавайте, переустанавливайте, перезапускайте и удаляйте серверы из своего кода: те же операции, что сегодня выполняет панель.
- Актуальный каталог
- Тарифы, регионы и образы в виде данных, с теми же ценами, что на витрине, включая вашу партнёрскую скидку, если она есть.
- Домены и DNS
- Поиск, регистрация и управление записями через ту же интеграцию с регистратором, что использует сайт.
- Использование и оплата
- Почасовой учёт использования, доступный программно: цифры, которые нужны, чтобы выставлять счета своим клиентам.
- Webhooks вместо опроса
- События жизненного цикла отправляются на ваш эндпоинт с подписью, чтобы ваши системы реагировали, а не опрашивали.
- Токены с ограниченными правами
- Ключи только для чтения, только для развёртывания или с полным доступом, мгновенно отзываемые, с журналом аудита для каждого токена.
Принципы, по которым мы строим API: простой REST с осмысленными кодами состояния, ключи идемпотентности для изменяющих вызовов, cloud-init user_data при создании, ограничения частоты запросов в заголовках ответа и ошибки, которые подсказывают, что делать дальше. Скучно, и так задумано.
Сообщить об интересе
Расскажите, что вы бы с ним создали.
Достаточно одного предложения о вашей задаче. Мы напишем, когда появится что-то реальное для пробы, а не серию рекламных рассылок.