HTTP API для реселлеров Bestname
Автоматизация доменных операций
API позволяет проверять доступность доменов, оформлять регистрацию и продление, менять NS, получать список клиентов, домены и состояние заявок. Используйте ключ своего реселлерского кабинета и разрешённый IP-адрес приложения.
Запросы отправляются методом POST через HTTPS. Секретный ключ передаётся в теле запроса. Номер заявки не означает, что регистрация уже завершилась: проверяйте итоговое состояние операции.
Справка по API
Все команды используют POST через HTTPS. Передайте api-key в теле запроса, а IP приложения добавьте в настройки реселлера. Не передавайте ключ в URL и не публикуйте его в коде. Параметры — простые значения без массивов; названия параметров не переводятся.
Для register, prolong и ns передавайте неизменный request-id при повторе одного запроса: 8–80 латинских букв, цифр, дефисов или подчёркиваний. Для другой операции нужен другой request-id. Без него повтор может создать новую заявку.
debug=1 для register, prolong и ns проверяет данные и возвращает условный order-id 1000 без создания заказа и списания. Для регистрации и продления проверяется достаточность баланса. 1000 не является номером реального заказа.
PENDING — ожидание; PROCESSING — обработка либо результат, требующий уточнения. DONE включает завершённые, отклонённые и отменённые заявки: это не отдельное подтверждение успешной регистрации. Проверяйте результат в заказе или в поддержке.
На адресах /api/… результат возвращается в JSON с HTTP 200: проверяйте success, при ошибке — descr. Лимит частоты возвращает HTTP 429. Неизвестные команды и неверные HTTP-методы не выполняются. debug, protection, jur и block-mail передавайте как true/false или 1/0.
Доступные команды API
check — Проверка доступности домена
Адрес POST:https://www.bestname.ua/api/check
Параметры кроме api-key: domain — полное доменное имя.
Ответ: success, available (true/false). simulation обозначает тестовую проверку, если она применена.
register — Регистрация домена
Адрес POST:https://www.bestname.ua/api/register
Параметры кроме api-key: domain; period — срок в годах в пределах зоны; request-id; user-id — существующий клиент. Для нового клиента вместо user-id: email, fio, country (код из двух букв), region, city, address, zip, phone. Для юридического лица: jur, company, edrpou. Дополнительно: ns1–ns3, ip1–ip3 для glue; block-mail; protection для поддерживаемых платных зон; license-ua для .ua; debug. Если NS не переданы, используются настройки реселлера.
Ответ: success, order-id. Без debug создаётся счёт и списывается баланс; это ещё не подтверждение регистрации.
prolong — Продление домена
Адрес POST:https://www.bestname.ua/api/prolong
Параметры кроме api-key: domain — домен вашего клиента; period — доступный срок; request-id; debug.
Ответ: success, order-id. Без debug создаётся счёт и списывается баланс.
prolongprice — Стоимость продления
Адрес POST:https://www.bestname.ua/api/prolongprice
Параметры кроме api-key: domain — домен вашего клиента; period — доступный срок в годах.
Ответ: success, price — массив с суммой за выбранный срок в UAH с учётом зоны и Privacy Protection. Списания нет.
ns — Смена NS
Адрес POST:https://www.bestname.ua/api/ns
Параметры кроме api-key: domain; ns1, ns2 и при необходимости ns3; ip1–ip3 для glue; request-id; debug. Нужны минимум два разных NS.
Ответ: success, order-id. Создание заявки не означает завершения изменений в реестре.
clients — Список клиентов
Адрес POST:https://www.bestname.ua/api/clients
Параметры кроме api-key: Дополнительных параметров нет.
Ответ: success, clients — массив ID активных клиентов реселлера.
domains — Домены клиента
Адрес POST:https://www.bestname.ua/api/domains
Параметры кроме api-key: client-id — ID вашего клиента.
Ответ: success, domains — массив доменных имён.
contacts — Контакты клиента
Адрес POST:https://www.bestname.ua/api/contacts
Параметры кроме api-key: client-id — ID вашего клиента.
Ответ: success, contacts: email, phone, country, region, city, address, jur, edrpou, company. Храните персональные данные защищённо, не записывайте ответ в общедоступные логи.
status — Состояние заявки
Адрес POST:https://www.bestname.ua/api/status
Параметры кроме api-key: order-id — номер заявки этого реселлера.
Ответ: success, status: PENDING, PROCESSING или DONE.