Orax Orax
Войти

Публичный REST API

2 мин чтения13.10.2026115 просмотров
В этой статье

У Orax есть публичный REST API: всё, что вы делаете в кабинете, можно делать программой.

Две половины

Открытая — без токена вообще. Те же страницы, что читает гость, отданные как JSON: база знаний, блог, отзывы, глоссарий, шаблоны, статус, курсы валют, список доменных зон и проверка домена. Параметр ?lang=uz|ru|en отдаёт переводы одной строкой.

Закрытая — по токену OAuth2: профиль, услуги и управление ими, заказы, кошелёк, домены, мониторы, сканы безопасности, аптайм услуги, серверы, AI.

Области доступа

Токен выдаётся с правами ровно на то, что нужно: profile, services:read/write, orders:read/write, wallet:read/write, ai:read/write, domains:read/write, monitors:read/write.

Домены и мониторы вынесены отдельно намеренно: так можно отдать read-only дашборд аптайма, не выдавая вместе с ним право тратить деньги.

Как начать

  1. Авторизуйтесь по OAuth2 и получите токен с нужными правами.
  2. Обращайтесь к /api/v1 с заголовком авторизации.
  3. Соблюдайте ограничение частоты — 90 запросов в минуту.

Документация

  • /developers — обзор: что умеет API, первый запрос, который работает без токена.
  • /api/docs — полный справочник (OpenAPI/Redoc). Он генерируется из самого кода: описанные права читаются с маршрутов, поэтому документация не может пообещать того, чего сервер не разрешает.

Что учесть

  • Деньги всегда в долларах, в минорных единицах (центах).
  • Списки отвечают {data, meta} с постраничностью; отказ возвращает стабильный ключ ошибки и понятное сообщение.
  • Ни один ответ не содержит паролей: пароли серверов, FTP и баз в API не представлены вовсе — токен на чтение не должен становиться root-доступом.
  • Выключенный в настройках раздел отдаёт 404 и по API тоже — это так задумано.

Для ai-агентов

Есть сервер MCP (/api/v1/mcp) — тот же аккаунт по стандартному протоколу Model Context Protocol. Первая версия только читает: никаких денег и ничего необратимого.

На этом же API работает мобильное приложение. Для партнёров есть отдельный реселлерский API с ключом.

Это было полезно?