API

dns-lookup

DNS-over-HTTPS на нашем сервере. Пригодится, когда у вызывающего нет свободного исходящего DNS или нужно сравнить ответы разных резолверов.

v1 beta server · 1 ток.

Цена (server): 1 ток. за вызов; с Премиумом −5 %, с округлением вверх. Точная сумма для вашего файла: POST /v1/tools/dns-lookup/estimate.

Вызов

POST https://timbrica.com/v1/tools/dns-lookup/runs
Authorization: Bearer $TIMBRICA_KEY
Idempotency-Key: <ваш ключ для безопасного повтора>
Content-Type: application/json

Вход

ПолеТипОбязательноеПояснение
name string да Доменное имя.
макс. длина: 253
type string нет Тип DNS-записи.
одно из: A, AAAA, MX, CNAME, NS, TXT, SOA, SRV, CAA, PTR
по умолчанию: A
resolver string нет
одно из: google, cloudflare, quad9
по умолчанию: google

Какие ошибки может вернуть

invalid_name  invalid_type  invalid_resolver  upstream_unavailable 

История

  • v1 — 2026-07-30 — Initial release.

Контракт не может измениться без новой версии и строки выше: тест сверяет опубликованную схему, цены и лимиты с закоммиченным lock-файлом и иначе роняет сборку. Подпишитесь на /v1/changelog, чтобы узнавать об изменениях.