Güvenlik ve Güven

security.txt API'si

Bir alan adının geçerli bir security.txt yayımlayıp yayımlamadığını tek istekle kontrol edin. Ayrıştırılmış alanları, son kullanmaya kalan günleri, imza varlığını ve makine tarafından kodlanmış hata ve uyarıları alın.

Dokümantasyonu görüntüle Ücretsiz aracı deneyin Tüm API'leri keşfedin

Uç Noktalar Aktif

GET /v1/security-txt

Örnek istek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/security-txt?domain=example.com"

Örnek yanıt 200 OK

{
  "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": []
}

Örnek istek GET /v1/security-txt

Temel Özellikler 4

Sık sorulan sorular 4

HTTP durum kodları 200 / 400 / 401 / 402 / 429 / 502

Kategori Güvenlik ve Güven

Uç Noktalar 1

Temel Özellikler 4

Sık sorulan sorular 4

Bu şirketlerdeki kişiler tarafından kullanılıyor

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Canlı Hizmet durumu

Entegrasyondan önce canlı hizmet durumunu ve belgelenmiş hata yanıtlarını kontrol edin.

OpenAPI API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

10,000 Ücretsiz hak

Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.

Bu API neyi yayına almanıza yardımcı olur

Bu sayfayı üretim özeti olarak kullanın: endpointler, örnekler, yanıt yapısı ve DomScan’i ürününüze bağlamak için gereken workflow parçaları.

Ürün workflow’ları

Domain kontrollerini, DNS istihbaratını, risk sinyallerini veya zenginleştirmeyi onboarding, arama ve dahili araçlara gömün.

Analist otomasyonu

Tekrarlanan manuel sorguları planlı işler, uyarılar ve yeniden üretilebilir araştırma adımlarıyla değiştirin.

Temiz JSON verisi

Sağlayıcı sayfalarını kazımak yerine öngörülebilir alanlar, belgelenmiş durum kodları ve kredi maliyetleri kullanın.

AI ve ops araçları

OpenAPI, SDK, Postman veya MCP üzerinden agent’ları, panoları, SOAR playbook’larını ve CRM’leri besleyin.

Entegrasyon workflow’u

İlk istekten tekrarlanabilir üretim kullanımına giden basit yol.

Bir kez doğrulayın

API anahtarınızı belgelenmiş header ile gönderin ve servisler arasında istekleri tutarlı tutun.

Örneklerle sorgulayın

curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.

İşletin ve izleyin

Retry, log ve uyarılar için durum kodlarını, kredi maliyetlerini ve yanıt alanlarını kullanın.

Geliştirici kiti

Bu sayfadan makine tarafından okunabilir dokümanlara, istek koleksiyonlarına, SDK’lere veya agent araçlarına geçin.

OpenAPI şeması

Client üretin veya her istek ve yanıt şeklini inceleyin.

Postman koleksiyonu

Manuel test ve ekip devri için hazır istekleri içe aktarın.

SDK’ler ve CLI

Boilerplate yazmak yerine bakımı yapılan paketleri ve komut satırı workflow’larını kullanın.

MCP entegrasyonu

Domain intelligence’ı AI agent’larına ve dahili asistan workflow’larına açın.

Parametre ve yanıt haritası

Endpoint’i client’ınıza bağlamadan önce girdileri, çıktı alanlarını ve durum kodlarını tarayın.

İstek parametreleri

Parametre

domainurl

Yanıt alanları

Örnek yanıt

domainstatuslocationfieldsfields.contactfields.expiresfields.expires_in_daysfields.policysignedissues

Durum kapsamı

HTTP durum kodları

200400401402429502

Uç Noktalar

GET /v1/security-txt

Kredi: 1Kimlik Doğrulama: Kimlik dogrulama gerekli

Entegrasyondan önce güven sinyalleri

Şeffaf dokümanlar, kimliği doğrulanmış istekler ve görünür güvenilirlik ayrıntıları, yayına almadan önce DomScan’i değerlendirmeyi kolaylaştırır.

Hizmet durumu API materyalleri

OpenAPI, Swagger, Postman, CLI, SDK ve MCP bağlantıları bir tık uzakta.

API anahtarları Korumalı erişim

Kimliği doğrulanmış endpointler, çağrıdan önce net kredi maliyetleriyle API anahtarları kullanır.

Ücretsiz hak Ücretsiz kaydolun

Aylık 10.000 krediyle başlayın ve yalnızca kullanım arttığında yükseltin.

Aktif Örnek istek

curl ve HTTP örneklerinden başlayın, sonra parametreleri uygulama kodunuza eşleyin.

Temel Özellikler

RFC 9116 doğrulama

Zorunlu Contact ve Expires alanları, URI biçimleri, HTTPS bağlantıları, Preferred-Languages ve Canonical kontrol edilir; hatalar ve uyarılar ayrı tutulur.

Konum yönetimi

Önce /.well-known/security.txt okunur, eski /security.txt ise yalnızca 404 veya 410 sonrasında.

Son kullanma izleme

Son kullanma tarihini ve kalan günleri döndürür; böylece bir açıklama politikası geçersiz kalmadan önce uyarı kurabilirsiniz.

Dört net durum

valid, invalid, not_found ve unknown. Engellenen veya başarısız getirmeler asla eksik dosya olarak bildirilmez.

Örnek istek

GET /v1/security-txt?domain=example.com bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/security-txt?domain=example.com"

Örnek yanıt

200 OK json

{
  "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": []
}

Sık sorulan sorular

Bir dosyayı geçersiz yapan nedir?

Eksik Contact veya Expires alanı, birden çok Expires alanı, süresi dolmuş tarih, geçersiz iletişim URI'leri, düz http bağlantıları veya metin yerine sunulan bir HTML sayfası.

İmzalar doğrulanıyor mu?

İmzalı dosyalar algılanır ve ayrıştırılır, ancak OpenPGP imzası doğrulanmaz.

Bir kontrol kaç istek yapar?

Bir; well-known konumu 404 veya 410 döndürüp eski konum denendiğinde iki.

Kaç kredi tutar?

İstek başına bir kredi. Bilinmiyor durumuyla biten istekler iade edilir.

İlgili araçlar ve kaynaklar

HTTP durum kodları

İstemcinizin işlemesi gereken HTTP durum kodları şunlardır; böylece başarılı yanıtları, kimlik doğrulama sorunlarını, kredileri, hız sınırlarını, eksik verileri ve üst kaynak hatalarını birbirinden ayırabilirsiniz.

OK 200

İstek başarılı

Hatalı İstek 400

Geçersiz parametreler

Yetkisiz 401

API anahtarı veya oturum eksik ya da geçersiz.

Ödeme Gerekli 402

Bu isteği çalıştırmak için yeterli krediniz yok.

Çok Fazla İstek 429

Hız sınırı aşıldı

Hatalı Ağ Geçidi 502

Yukarı akış RDAP hatası

security.txt kontrol edin

Ücretsiz başlayın Dokümantasyonu görüntüle Ücretsiz aracı deneyin