API интеграция

Подключите API HostHub к своей системе

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

Поддерживаются кириллические домены, в том числе в зоне .рф

API — это способ, с помощью которого две программы обмениваются данными и выполняют действия без ручной работы в личном кабинете

Открыть документацию

Запросить доступ к API

Для подключения понадобится разработчик или специалист, который настраивает вашу систему

Кому подходит api интеграция

Когда полезна API интеграция HostHub

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

Владельцу нескольких доменов

чтобы видеть сроки их действия и настроить контроль продления

Веб-студии или агентству

чтобы работать с доменами и DNS через собственную панель

Компании

чтобы получать сведения об услугах и счетах в своей учетной системе

Разработчику

чтобы добавить возможности HostHub в сайт, приложение или внутренний сервис

Интеграция — это подключение одной программы к другой. Например, ваша система запрашивает у HostHub список доменов и показывает его вашим сотрудникам

возможности api

Доступные операции

Домены

Просматривайте свои домены, проверяйте сроки их действия, меняйте NS-серверы, регистрируйте новые домены и продлевайте действующие. API поддерживает кириллические домены, включая .рф

DNS

Просматривайте, добавляйте, изменяйте и удаляйте DNS-записи для доменов, у которых указаны NS-серверы HostHub. DNS-записи - это настройки, которые направляют домен на нужный сайт или помогают работать почте

Хостинговые услуги

Получайте сведения о подключенных услугах: тарифе, состоянии, периоде оплаты и других доступных параметрах

Счета

Просматривайте список счетов, суммы к оплате и сведения о начислениях

Каталог

Получайте информацию о тарифах и ценах доменных зон, проверяйте, свободно ли доменное имя

Важно: API работает с данными клиента, которому выдан ключ доступа. Данные других клиентов через него недоступны

как подключить Api

Четыре шага до интеграции

Определите задачу

Решите, что должна делать ваша система: показывать домены, обновлять DNS, получать счета или заказывать домены

Запросите доступ

Обратитесь в поддержку HostHub. Укажите нужные действия, а также адреса серверов, с которых будут поступать запросы, если они постоянны

Получите токен

Токен — это секретный ключ, по которому HostHub распознает вашу программу. Для него назначаются права: например, только просмотр данных или возможность менять DNS-записи

Настройте и проверьте интеграцию

Разработчик подключает вашу систему к API, проверяет доступ и затем добавляет нужные операции

Запросить токен

Токен следует хранить как пароль. Его нельзя размещать в открытом коде сайта или передавать посетителям

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

Инструкции, методы и примеры запросов

Руководство по интеграции

Документация содержит адрес API, правила подключения, описание всех доступных операций, примеры запросов и ответов, а также объяснение возможных ошибок. В руководстве есть примеры для PHP, Python и Node.js.

PHP

Python

Node.js

Интерактивная документация

Доступна и интерактивная документация Swagger. В ней разработчик может посмотреть актуальные методы и проверить запросы прямо на странице

Метод API — это конкретная операция, которую может запросить программа. Например, получить список доменов или изменить DNS-запись

Открыть Swagger

Скачать руководство по интеграции

Важно: проверочные запросы в Swagger выполняют реальные действия. Регистрация или продление домена приведет к списанию средств с баланса

Условия и лимиты API

Ограничения, которые нужно знать заранее

Условия работы и лимиты API

Чтобы правильно спланировать интеграцию, учитывайте возможности текущей версии:

Управление DNS доступно только для доменов, у которых указаны NS-серверы HostHub. Если используются NS-серверы другого провайдера, DNS-записи нужно менять у этого провайдера

Лимит API - 60 запросов в минуту

Учитывайте его при настройке автоматических проверок, обновлении данных и обработке нескольких доменов

Хостинговые услуги можно просматривать, но нельзя заказать, сменить или отключить через API

Счета можно просматривать, но нельзя оплатить картой через API

Регистрация и продление доменов оплачиваются только из заранее пополненного кредитного баланса

Перенос домена от другого регистратора через API недоступен

Массовых операций нет: каждый домен обрабатывается отдельным запросом

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

NS-серверы — это серверы, которые указывают, где обслуживаются DNS-записи домена

Кредитный баланс — это деньги, заранее внесенные на счет клиента для оплаты операций

Массовая операция — одно действие сразу с несколькими доменами

Помощь с подключением

Расскажите, что хотите автоматизировать

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

Частые вопросы

Что важно знать перед подключением

Нужно ли мне подключать API, чтобы пользоваться HostHub?

Нет. Домены и услуги доступны через обычный личный кабинет. API нужен, если вы хотите связать HostHub со своей программой или автоматизировать повторяющиеся действия

Могу ли я настроить интеграцию самостоятельно?

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

Поддерживает ли API домены на кириллице?

Да. API поддерживает кириллические домены, в том числе в зоне .рф

Можно ли управлять DNS любого моего домена?

Управление DNS через API доступно, только если у домена указаны NS-серверы HostHub. Если указаны NS-серверы другого провайдера, записи нужно менять у него

Сколько запросов можно отправлять?

Лимит составляет 60 запросов в минуту. Разработчику нужно учитывать его при настройке частоты обновлений и последовательной обработке доменов

Может ли моя программа увидеть данные другого клиента?

Нет. Ключ подключения дает доступ к данным конкретного клиента и только к разрешенным для этого ключа действиям

Можно ли сначала просто проверить подключение?

Да. Можно запросить ключ с правами только на просмотр и проверить получение данных. Права на изменение настроек и заказ доменов можно добавить для отдельного ключа, когда интеграция будет готова

Домен появится сразу после запроса на регистрацию?

Запрос на заказ обрабатывается сразу, но фактическая регистрация может занять некоторое время. Итоговое состояние домена нужно проверить отдельным запросом

Что делать, если программа получила ошибку?

Разработчик может посмотреть код ошибки в документации. При обращении в поддержку полезно передать request_id - номер конкретного запроса, по которому проще найти его в журнале

полезные материалы и помощь

С чего начать изучение API

Что такое API простыми словами

Как две программы обмениваются данными и в каких случаях это полезно бизнесу

Как подготовиться к интеграции с HostHub

Какие задачи описать разработчику и что сообщить при запросе доступа

Как защитить ключ доступа к API

Где хранить токен и почему его нельзя размещать в открытом доступе

Как автоматизировать контроль сроков доменов

Пример задачи: получать даты окончания доменов и заранее находить те, которые пора продлить

Нужна помощь с подключением?

Опишите, какую систему вы хотите связать с HostHub и какие действия хотите автоматизировать. Мы поможем определить, какие возможности API подходят для вашей задачи

Имя

Компания

Телефон или email

Ваша задача