Перейти к содержимому
POST AI agent ready /v1/dns/lookup

API поиска DNS — бесплатный запрос DNS-записей

Запрашивает DNS-записи для домена, используя Cloudflare DNS-over-HTTPS. Поддерживает типы записей A, AAAA, MX, TXT, CNAME, NS, SOA и PTR.

Parameters

stringrequired

Domain name to look up.

string

DNS record type to query.

Code examples

curl -X POST https://api.botoi.com/v1/dns/lookup \
  -H "Content-Type: application/json" \
  -d '{"domain":"github.com","type":"A"}'

When to use this API

Проверка конфигурации домена во время регистрации

Когда клиент добавляет личный домен на вашу платформу SaaS, запросите его записи CNAME или A, чтобы убедиться, что DNS указывает на ваши серверы. Поставьте зеленую галочку, как только записи будут соответствовать ожидаемым значениям.

Отслеживайте изменения записей MX для обеспечения доставляемости электронной почты.

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

Аудит записей TXT на предмет соответствия SPF и DKIM.

Запросите записи TXT для домена, чтобы извлечь записи SPF и DKIM. Проанализируйте значения, чтобы убедиться, что они соответствуют ожидаемой конфигурации, и пометьте домены с отсутствующими или чрезмерно разрешительными политиками.

Frequently asked questions

Какой преобразователь DNS использует эта конечная точка?
Запросы проходят через Cloudflare DNS-over-HTTPS (1.1.1.1). Это обеспечивает быстрое разрешение проблем с соблюдением конфиденциальности без кэширования устаревших записей.
Какие типы записей поддерживаются?
A, AAAA, CNAME, MX, NS, TXT, SOA, SRV, CAA и PTR. Укажите параметр типа; по умолчанию он равен A, если опущен.
Могу ли я искать субдомены?
Да. Передайте полный субдомен (например, «api.github.com») в качестве параметра домена. Конечная точка разрешает любую предоставленную вами строку домена.
Что представляет собой query_time_ms?
query_time_ms — это время в миллисекундах, которое потребовалось для разрешения DNS на стороне сервера. Оно не включает время прохождения по сети от вашего клиента до API.
Возвращает ли это все записи запрошенного типа?
Да. Если в домене имеется несколько записей A или несколько записей MX, все они возвращаются в массиве записей с отдельными значениями срока жизни.

Get your API key

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