CoreRack / Developers

Проект API · v1

CoreRack API.

Ваша инфраструктура.
Под управлением вашего кода.

Каталог, заказы и управление VPS — единый интерфейс для ваших приложений и биллинга.

REST / JSON Bearer token HTTPS

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

01 / Подключение

От ключа до первого запроса.

Подготовьте доступ

После запуска API войдите в подтверждённый аккаунт. Выпуск ключей будет доступен в отдельном разделе кабинета; сейчас он не реализован.

Сохраните ключ на сервере

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

Передайте заголовок авторизации

Каждый запрос использует Authorization: Bearer <API_KEY>. Отправляйте данные только по HTTPS.

Получите локации и тарифы

Начните с чтения каталога, затем выберите совместимые тариф, локацию и образ ОС. Перед платным заказом подтвердите стоимость.

02 / Справочник

Запрос. Ответ. Результат.

Предлагаемые методы CoreRack. Примеры ответов статические и не выполняют операций.

GET/v1/locations

Список локаций

Идентификаторы локаций для подбора тарифа и создания сервера.

Запрос · curl

curl --request GET \
  'https://api.corerack.example/v1/locations' \
  --header "Authorization: Bearer $CORERACK_API_KEY"

Пример ответа · JSON

{
  "data": [{
    "id": "de",
    "country": "Германия",
    "city": "Франкфурт"
  }]
}

03 / Диагностика

Понятные ошибки.

Предлагаемая схема ошибок. Проверяйте HTTP-статус перед чтением результата; точные коды будут утверждены при запуске.

400

Некорректный запрос

Проверьте параметры, тариф и образ ОС.

401

Нет авторизации

Проверьте заголовок Bearer и действительность ключа.

403

Недостаточно прав

Проверьте владельца сервера и разрешения ключа.

404

Ресурс не найден

Проверьте идентификатор сервера или тарифа.

429

Слишком много запросов

Сделайте паузу; учитывайте Retry-After, если он возвращён.

5xx

Ошибка сервиса

Повторяйте чтение с задержкой; перед повтором заказа проверьте его состояние.

04 / Экосистема

В вашем рабочем процессе.

WHMCS

Планируется

Планируемый сценарий: каталог тарифов, оформление заказа и управление сервером из биллинга. Готового модуля пока нет.

BILLmanager

Планируется

RootPanel

Планируется

Для собственного приложения используйте HTTP-клиент на сервере. Готовые SDK и установочные файлы CoreRack пока не опубликованы.

Обсудить интеграцию

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

Ключ — только у вас.

Не передавайте ключ в URL, логах или клиентском JavaScript. Используйте отдельный ключ для каждой интеграции и минимально необходимые права, когда управление правами станет доступно.

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