POST AI agent ready /v1/dns-monitor/check

API мониторинга DNS — бесплатное обнаружение изменений DNS

Запрашивает текущие записи DNS для домена и сравнивает их с сохраненным снимком предыдущей проверки. Возвращает разницу, показывающую, какие типы записей были изменены, каковы были предыдущие значения и каковы текущие значения. Снимки хранятся 7 дней. При первой проверке текущее состояние сохраняется и об изменениях не сообщается.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/dns-monitor/check \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com","types":["A","MX","NS"]}'

When to use this API

Обнаружение несанкционированных изменений DNS

Запланируйте периодические проверки своих рабочих доменов на предмет обнаружения перехвата DNS, случайного удаления записей или несанкционированных изменений. Вызов оповещения, когда Changes_detected имеет значение true.

Проверка полноты миграции DNS

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

Мониторинг доменов конкурентов или партнеров

Отслеживайте изменения DNS на сторонних доменах, от которых вы зависите. Обнаруживайте, когда партнер меняет свои записи MX (переключение поставщика электронной почты) или записи A (миграция хостинга).

Frequently asked questions

Как долго хранятся снимки?

Снимки хранятся 7 дней. Если вы не проверите домен в течение 7 дней, срок действия предыдущего снимка истечет, и следующая проверка начнется заново, без данных для сравнения.

Какие типы записей DNS поддерживаются?

A, AAAA, MX, TXT, NS, CNAME, SOA и PTR. Если вы опустите параметр типов, проверяется набор по умолчанию (A, AAAA, MX, TXT, NS, CNAME).

Могу ли я использовать это для мониторинга работоспособности?

Эта конечная точка проверяет записи DNS, а не доступность HTTP. Для мониторинга времени безотказной работы HTTP используйте вместо этого конечную точку /v1/uptime/check.

Что происходит при первой проверке?

Первая проверка сохраняет текущее состояние DNS в качестве базового. Он возвращает Changes_detected: false и previous_check: null. Последующие проверки сравниваются с этим базовым уровнем.

Чувствительно ли сравнение к регистру?

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

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.