ITGroup / Reseller API

Тема

Reseller API ​

REST API для подключения собственного биллинга реселлера: клиенты, контакты владельцев, тарифы, регистрация, продление, перенос и управление доменами, заказы, баланс и уведомления.

Базовый путь: /api/reseller/v1. Адрес сервера и ключ выдаёт оператор платформы. Наличие этой документации не означает, что API уже включён на конкретном сервере.

Начать интеграцию ​

  1. Быстрый старт: доступ, окружение, первая проверка, подбор прав.
  2. Модель данных: реселлер и клиент, идентификаторы, деньги и расчёты.
  3. Регистрация домена: полный процесс от контакта до подтверждённой регистрации.
  4. Управление доменом: продление, перенос, восстановление, NS, контакты, блокировки и ЭЦП.
  5. Надёжность: ошибки, rate limit, идемпотентность и повторные запросы.
  6. Webhooks: подпись, повторная доставка и синхронизация состояния.
  7. Исполняемые примеры и критерии готовности интеграции.

Справочник и загрузки ​

В разделе методов приведены конкретные запросы и ответы, права, параметры, вложенные поля и условия ошибок. Справочник генерируется из того же контракта, который используется для машинных загрузок.

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

Границы API ​

API использует серверные Bearer-ключи, а не сессию личного кабинета. Реселлер работает только со своими объектами и своим окружением. Поддержка конкретной операции зависит от зоны и регистратора: проверяйте GET /domains/{domainUuid}/capabilities.

Управление NS и glue-записями не является управлением DNS-зоной: методов A, MX, TXT или CNAME здесь нет. Поддержку DNSSEC нельзя выводить из наличия EPP: отдельного публичного метода для него в этой версии нет. POST /hosting/orders позволяет заказать хостинг, но не обещает полный API управления хостинговой панелью.

HTTP 201 при создании заказа и 202 при постановке операции не подтверждают выполнение команды в реестре. Результат отслеживается отдельно. При неизвестном результате нельзя создавать новую платную операцию, пока не выяснен исход предыдущей.