Интеграции

Интеграция с ISPmanager

NexDNS обеспечивает полную совместимость с API DNSmanager, поэтому вы можете подключить NexDNS к ISPmanager как вторичный DNS-сервер. ISPmanager остаётся первичным сервером и, после того как вы разрешите передачу зоны (AXFR) с IP-адреса источника NexDNS, передаёт каждую зону в NexDNS, поэтому управление записями по-прежнему ведётся в ISPmanager. Полный API DNSmanager для доменов и записей также доступен для прямого использования через единую точку совместимости.

Точка подключения

Все вызовы совместимого API направляются через единую точку:

https://api.nexdns.ru/dnsmgr

Аутентификация

Совместимый API использует для аутентификации отдельный логин и секрет интеграции, которые вы создаёте в NexDNS в разделе Аккаунт → Интеграции (а не пароль вашей учётной записи). ISPmanager передаёт их с каждым запросом; вы также можете открыть сессию вручную с помощью функции func=auth и повторно использовать полученный токен.

curl -X POST "https://api.nexdns.ru/dnsmgr?func=auth" \
    -d "username=your_integration_login" \
    -d "password=your_integration_secret"

Успешный ответ (XML):

<doc><auth id="SESSION_ID"/></doc>

Для получения ответа в формате JSON добавьте out=json к любому запросу. Повторные неудачные попытки входа временно ограничиваются.

Поддерживаемые функции

Совместимый API выполняет операции на основе параметра запроса func:

Подключение ISPmanager к NexDNS

Чтобы подключить ISPmanager к NexDNS:

1. Зарегистрируйте аккаунт NexDNS на nexdns.ru и выберите тариф, включающий интеграцию с ISPmanager и вторичный DNS.
2. Настройте интеграцию в NexDNS: откройте Аккаунт → Интеграции, нажмите «Создать секрет», затем включите доступ для ISPmanager (по умолчанию выключен). Этот канал обходит двухфакторную аутентификацию, поэтому при желании привяжите его к фиксированному IP-адресу.
3. В ISPmanager добавьте NexDNS как вторичный DNS-сервер для ваших доменов (Доменные имена → вторичные серверы имён).
4. Введите параметры подключения:
   • Адрес: https://api.nexdns.ru/dnsmgr
   • Логин: ваш логин интеграции из раздела Аккаунт → Интеграции
   • Секрет: ваш секрет интеграции
5. Разрешите передачу зоны (AXFR): на первичном DNS-сервере разрешите передачу зоны с IP-адреса источника NexDNS, указанного в разделе Аккаунт → Интеграции. Без этого ISPmanager создаёт вторичную зону, но она остаётся пустой.

ISPmanager остаётся первичным сервером, и вы продолжаете управлять записями в нём; NexDNS забирает каждую зону как вторичную по AXFR. Разовый шаг с вашей стороны: на первичном DNS-сервере разрешите зонную передачу (AXFR) с IP-адреса источника NexDNS, указанного в разделе «Аккаунт → Интеграции», иначе зоны останутся пустыми. Аутентификация использует логин и секрет интеграции из раздела «Аккаунт → Интеграции»; убедитесь, что доступ ISPmanager включён и ваш тариф включает вторичный DNS.

Параметры записей

При создании или обновлении записей через domain.record.edit используются следующие параметры в зависимости от типа записи:

Для обновления передайте rkey с ID существующей записи. Опустите rkey (или передайте пустое значение) для создания новой записи.

Формат вывода

По умолчанию все ответы возвращаются в формате XML. Добавьте out=json к любому запросу для получения ответов в формате JSON.

Управление API-ключами

API-ключи используются для аутентификации запросов к REST API NexDNS. Каждый ключ имеет набор разрешений и может иметь дату истечения срока действия.

Создание API-ключа

Создать API-ключ можно двумя способами:

• Панель управления: перейдите в Настройки > API-ключи и нажмите «Создать API-ключ»
• REST API: POST /v1/account/api-keys (требуется существующий API-ключ)

Формат ключа

API-ключи имеют формат nxd_, за которым следуют 40 случайных буквенно-цифровых символов. Полный ключ показывается только один раз при создании. NexDNS хранит только хешированную форму ключа, поэтому при утере восстановить его невозможно.

nxd_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd

Разрешения

Каждому API-ключу необходимо назначить хотя бы одно разрешение. Доступные разрешения:

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

Срок действия

API-ключи могут иметь дату истечения срока действия. При установке ключ перестанет работать после указанной даты (проверка в полночь UTC). Просроченные ключи возвращают ответ 401 Unauthorized.

Отзыв ключа

Вы можете отозвать любой API-ключ в любое время через страницу настроек или через API. Отзыв немедленный и необратимый – ключ удаляется, а не отключается.

curl -X DELETE "https://api.nexdns.ru/v1/account/api-keys/{id}" \
    -H "Authorization: Bearer nxd_your_api_key"

Требования к тарифу

Доступ к API требует тарифного плана с функцией api_access.

Ограничение запросов

API NexDNS применяет ограничения запросов для обеспечения справедливого использования и стабильности сервиса. Ограничения применяются к аккаунту пользователя (не к API-ключу), поэтому использование нескольких API-ключей не увеличивает лимит.

Лимиты

Неаутентифицированные запросы (или запросы с недействительными ключами) ограничиваются по IP-адресу.

Заголовки ограничения запросов

Каждый ответ API содержит заголовки, указывающие текущий статус ограничения запросов:

Превышение лимита

При превышении лимита API возвращает 429 Too Many Requests:

{
    "status": "error",
    "error": {
        "code": "rate_limit_exceeded",
        "message": "Too many requests. Please retry after {timestamp}."
    }
}