Reseller API и вебхуки

Реселлерский API позволяет вести услуги ваших клиентов программно — от заказа до управления сайтом внутри аккаунта.

Доступ

Персональный ключ реселлера: рабочий начинается с rsk_…, песочница — rsk_test_…. Действует ограничение частоты (60 запросов в минуту).

Что можно

• Аккаунт и каталог: баланс, лимиты, оптовые и розничные цены (валюту можно запросить параметром).
• Заказ услуги и её жизненный цикл: приостановить, снять приостановку, заморозить, разморозить, расторгнуть.
• Продление: продлить на N периодов и включить автопродление. Это обязательно — без автопродления или явного продления услуга клиента умрёт в конце первого периода.
• Смена тарифа: список доступных тарифов и переключение.
• Вход в панель за клиента: одноразовая сессия панели, чтобы ваш клиент попал внутрь без отдельного пароля.
• Управление содержимым аккаунта: домены, DNS, базы, FTP, почта, SSL, cron, PHP, логи, файлы (включая загрузку и откат), SSH-ключи, шелл, бэкапы.
• Наблюдение: аптайм, нагрузка, сканы безопасности, мониторы.
• Покупка шаблонов по оптовой цене на услугу клиента.

Про деньги

Суммы приходят как {usd_cents, currency, amount, display}: считается всегда usd_cents, остальное — для показа клиенту.

Продление предоплачено: кредитный лимит покрывает только первичный заказ.

Вебхуки

На события услуг приходят подписанные POST-запросы — проверяйте подпись у себя. Если ваш адрес не отвечает десять раз подряд, мы отключаем вебхук и сообщаем вам: мёртвая точка не должна бесконечно копить очередь.

Советы

• Сначала проверьте интеграцию в песочнице.
• Храните ключ в секрете; при утечке перевыпустите.
• Помечайте услуги своим client_ref — по нему вы связываете их со своими клиентами.

Агент на вашем ключе (mcp)

Тем же ключом подключается ИИ-агент — по стандарту MCP, адрес https://orax.uz/api/v1/reseller/mcp. Ключ передаётся как обычный Bearer-токен, отдельной авторизации не нужно.

Что агент умеет спросить:

• Состояние счёта: баланс, наценка, потрачено оптом.
• Каталог с обеими ценами сразу — оптовой и рекомендованной розничной по вашей наценке.
• Ваши услуги: по конкретному клиенту (client_ref), по статусу или только те, что истекают в ближайшие N дней. В каждой строке сказано, продлится ли услуга сама.
• Одну услугу подробно: срок, нужно ли вмешиваться, открывается ли сайт и сколько дней осталось у сертификата.

Чего агент не умеет: заказывать, продлевать, тратить ваш баланс. Это осталось на обычных методах API, где интеграцию писал человек.