Публичный REST API
У 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 дашборд аптайма, не выдавая вместе с ним право тратить деньги.
Как начать
- Авторизуйтесь по OAuth2 и получите токен с нужными правами.
- Обращайтесь к /api/v1 с заголовком авторизации.
- Соблюдайте ограничение частоты — 90 запросов в минуту.
Документация
- /developers — обзор: что умеет API, первый запрос, который работает без токена.
- /api/docs — полный справочник (OpenAPI/Redoc). Он генерируется из самого кода: описанные права читаются с маршрутов, поэтому документация не может пообещать того, чего сервер не разрешает.
Что учесть
- Деньги всегда в долларах, в минорных единицах (центах).
- Списки отвечают {data, meta} с постраничностью; отказ возвращает стабильный ключ ошибки и понятное сообщение.
- Ни один ответ не содержит паролей: пароли серверов, FTP и баз в API не представлены вовсе — токен на чтение не должен становиться root-доступом.
- Выключенный в настройках раздел отдаёт 404 и по API тоже — это так задумано.
Для ai-агентов
Есть сервер MCP (/api/v1/mcp) — тот же аккаунт по стандартному протоколу Model Context Protocol. Первая версия только читает: никаких денег и ничего необратимого.
На этом же API работает мобильное приложение. Для партнёров есть отдельный реселлерский API с ключом.
Orax