ライブ
サービスステータス
統合前に、現在のサービス稼働状況と文書化されたエラー応答を確認してください。
セキュリティと信頼性
セキュリティ連絡先ファイル検証API
1回のリクエストで、ドメインが有効なsecurity.txtを公開しているかを確認します。解析された項目、有効期限までの日数、署名の有無、機械可読なコード付きのエラーと警告を取得できます。
カテゴリ
セキュリティと信頼性
エンドポイント
1
主な機能
4
よくある質問
4
これらの企業の担当者に使われています
統合前に確認できる信頼シグナル
透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。
OpenAPI
API アーティファクト
OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。
API キー
保護されたアクセス
認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。
10,000
無料枠
毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。
この API で実装できること
このページを本番導入向けの概要として使えます。エンドポイント、例、レスポンス形状、DomScan を製品に組み込むためのワークフローをまとめています。
ドメイン確認、DNS インテリジェンス、リスクシグナル、エンリッチメントをオンボーディング、検索、社内ツールに組み込めます。
繰り返しの手動検索を、スケジュールジョブ、アラート、再現可能な調査手順に置き換えます。
提供元ページをスクレイピングせず、予測可能なフィールド、文書化済みステータスコード、クレジットコストを使えます。
OpenAPI、SDK、Postman、MCP を通じて、エージェント、ダッシュボード、SOAR プレイブック、CRM に接続できます。
統合ワークフロー
最初のリクエストから本番で繰り返し使える状態までのシンプルな流れです。
一度認証する
文書化されたヘッダーで API キーを送信し、サービス間で一貫したリクエストを保ちます。
例から問い合わせる
curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。
運用と監視
ステータスコード、クレジットコスト、レスポンスフィールドを使ってリトライ、ログ、アラートを構築します。
開発者キット
機械可読なドキュメント、リクエスト集、SDK、エージェント用ツールへすぐ移動できます。
パラメータとレスポンスのマップ
クライアントに接続する前に、入力、出力フィールド、ステータスコードを確認できます。
パラメータ
domainurl
レスポンス例
domainstatuslocationfieldsfields.contactfields.expiresfields.expires_in_daysfields.policysignedissues
HTTP ステータスコード
200400401402429502
エンドポイント
GET
/v1/security-txt
統合前に確認できる信頼シグナル
透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。
サービスステータス
API アーティファクト
OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。
API キー
保護されたアクセス
認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。
無料枠
無料でサインアップ
毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。
アクティブ
リクエスト例
curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。
主な機能
RFC 9116の検証
必須のContactとExpires、URIの形式、HTTPSリンク、Preferred-Languages、Canonicalを確認し、エラーと警告を分けて返します。
ロケーションの扱い
まず/.well-known/security.txtを読み取り、404または410の後にのみ従来の/security.txtを確認します。
有効期限の監視
有効期限と残り日数を返すため、脆弱性開示ポリシーが失効する前にアラートを出せます。
4つの明確なステータス
valid、invalid、not_found、unknownです。ブロックされた場合や取得に失敗した場合に、ファイルがないと報告されることはありません。
リクエスト例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/security-txt?domain=example.com"レスポンス例
{
"domain": "example.com",
"status": "valid",
"location": "well_known",
"fields": {
"contact": ["mailto:[email protected]"],
"expires": "2027-01-01T00:00:00.000Z",
"expires_in_days": 83,
"policy": ["https://example.com/security-policy"]
},
"signed": false,
"issues": []
}よくある質問
どのような場合にファイルが無効になりますか？
ContactまたはExpiresの欠落、複数のExpires、期限切れの日付、不正な連絡先URI、プレーンなhttpリンク、テキストの代わりに返されたHTMLページが該当します。
署名は検証されますか？
署名付きファイルは検出されて解析されますが、OpenPGP署名の検証は行いません。
1回のチェックで何回リクエストしますか？
1回です。well-knownの場所が404または410を返して従来の場所を試す場合は2回になります。
クレジットはいくら必要ですか？
1リクエストにつき1クレジットです。不明の状態で終わったリクエストは返金されます。
関連ツールとリソース
HTTP ステータスコード
正常な応答、認証の問題、クレジット不足、レート制限、データ未検出、上流サービス障害を判別できるよう、クライアントで処理すべきHTTPステータスコードを明記しています。
成功
200
リクエスト成功
不正なリクエスト
400
無効なパラメータ
未認証
401
APIキーまたはセッションが不足しているか無効です。
支払いが必要
402
このリクエストを実行するためのクレジットが不足しています。
リクエスト過多
429
レート制限を超過
不正なゲートウェイ
502
上流 RDAP エラー