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

DNS モニタリング API - 無料の DNS 変更検出

ドメインの現在の DNS レコードをクエリし、以前のチェックで保存されたスナップショットと比較します。変更されたレコードタイプ、以前の値、および現在の値を示す diff を返します。スナップショットは 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。 type パラメータを省略すると、デフォルトのセット (A、AAAA、MX、TXT、NS、CNAME) がチェックされます。

これを稼働時間の監視に使用できますか?

このエンドポイントは、HTTP の可用性ではなく、DNS レコードをチェックします。 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.