Документация для разработчиков

API JoOnly

Инфраструктура с душой. Серверы, которые дышат. Создавайте устойчивые решения, интегрируясь с нашим RESTful API.

Введение: Как начать работать с API

API JoOnly построен по принципам REST и использует стандартные HTTP-методы для управления ресурсами. Все ответы возвращаются в формате JSON. Мы стремимся к предсказуемости и мягкости взаимодействия, чтобы ваш код рос гармонично.

          GET https://api.joonly.cloud/v1/servers

          POST https://api.joonly.cloud/v1/servers

          DELETE https://api.joonly.cloud/v1/servers/{id}

Базовый URL для всех запросов: https://api.joonly.cloud/v1

Безопасность

Аутентификация: API-ключи и токены

Мы защищаем ваши данные так же бережно, как природа. Используйте Bearer-токены для авторизации.

Использование токена

Ваш API-ключ можно сгенерировать в панели управления. Передавайте его в заголовке каждого запроса:

        Authorization: Bearer jo_live_58f3a...9b2x
      

Важно: Никогда не публикуйте свои ключи в публичных репозиториях. Мы автоматически валидируем токены каждые 24 часа.

Инфраструктура

Управление серверами

Создание, удаление и перезагрузка инстансов через простые эндпоинты.

Создание сервера

Запустите новый инстанс, указав регион и конфигурацию.

          POST /servers

          {

            "name": "eco-web-01",

            "plan": "sage-standard",

            "region": "eu-north-1"

          }

Перезагрузка

Мягкая перезагрузка сервера без потери данных в оперативной памяти (если поддерживается ОС).

          POST /servers/{id}/reboot
        

Удаление

Полное удаление сервера и освобождение ресурсов. Это действие необратимо.

          DELETE /servers/{id}
        

События и Webhooks

Отслеживайте изменения в реальном времени. JoOnly отправляет уведомления о событиях (создание, остановка, изменение статуса) на ваш URL.

✓ server.created
✓ server.failed
✓ billing.invoiced

Подпись запроса проверяется через заголовок X-JoOnly-Signature.

Real-time Sync

Инструменты

SDK и примеры кода

Ускорьте разработку с помощью официальных библиотек. Мы поддерживаем основные языки, чтобы вы могли говорить на своем.

Py

Python

pip install joonly-sdk

Смотреть документацию →

Js

Node.js

npm install @joonly/cloud

Смотреть документацию →

Go

go get github.com/joonly/go-sdk

Смотреть документацию →

Нужна помощь с кодом?

Наши инженеры помогут вам настроить интеграцию или оптимизировать запросы к API.