Gugu
Araçlar
TR

Geliştirici & API

Genel Araçlar API Belgesi

Gugu; SPF, DKIM, DMARC, MX ve IP kara liste denetimleri için ücretsiz ve herkese açık HTTP GET uç noktaları sunar. Kayıt veya API anahtarı gerekmez.

Ücretsiz ve Açık Hizmet

Ücretsiz ve Açık

Tüm genel araç uç noktaları herkese açıktır. Önceden kayıt olmanız veya API anahtarı (token) almanız gerekmez.

HTTP 429

Hız Sınırı (Rate Limit)

İstemci IP adresi başına saatte en çok 60 istek yapılabilir. Sınır aşıldığında HTTP 429 yanıtı döndürülür.

60s TTL

Sunucu Önbelleği

Aynı parametrelerle yapılan sorguların sonuçları sunucu tarafında 60 saniye boyunca önbellekte saklanır.

HTTPS

Temel URL

https://gugu.tr

Mevcut Uç Noktalar

Aşağıdaki GET /api/v1/tools/* uç noktaları doğrudan JSON yanıtı döndürür.

Bulgu metinleri için isteğe ?lang=tr, en, de, fr veya sr ekleyin; geçersiz ya da eksik değer Türkçe döner.

GET/api/v1/tools/spf?domain=example.com

SPF Kaydı Kontrolü

Alan adının SPF TXT kaydını sorgular, mekanizmaları ve sözdizimini doğrular.

Parametreler:

domain: Sorgulanacak alan adı (örn. example.com)

Örnek cURL:
curl -s "https://gugu.tr/api/v1/tools/spf?domain=example.com"
GET/api/v1/tools/dkim?domain=example.com&selector=default

DKIM Anahtar Kontrolü

Belirtilen selector ve alan adı için DKIM genel anahtar TXT kaydını doğrular.

Parametreler:

domain: Alan adı, selector: DKIM seçicisi (örn. default)

Örnek cURL:
curl -s "https://gugu.tr/api/v1/tools/dkim?domain=example.com&selector=default"
GET/api/v1/tools/dmarc?domain=example.com

DMARC Politikası Kontrolü

_dmarc kaydındaki DMARC politikasını, hizalama kurallarını ve raporlama etiketlerini inceler.

Parametreler:

domain: Sorgulanacak alan adı (örn. example.com)

Örnek cURL:
curl -s "https://gugu.tr/api/v1/tools/dmarc?domain=example.com"
GET/api/v1/tools/bimi?domain=example.com

BIMI Kaydı Kontrolü

Alan adının BIMI kaydını, logo bağlantısını ve DMARC şartlarını denetler.

Parametreler:

domain: Sorgulanacak alan adı (örn. example.com)

Örnek cURL:
curl -s "https://gugu.tr/api/v1/tools/bimi?domain=example.com"
GET/api/v1/tools/mx?domain=example.com

MX Teslim Yolu Kontrolü

Alan adının MX hedeflerini, öncelik sırasını, IP adreslerini ve sağlayıcı bilgisini listeler.

Parametreler:

domain: Sorgulanacak alan adı (örn. example.com)

Örnek cURL:
curl -s "https://gugu.tr/api/v1/tools/mx?domain=example.com"
GET/api/v1/tools/domain-scan?domain=example.com

Domain Taraması

SPF, DMARC, MX, BIMI, MTA-STS ve TLS-RPT kayıtlarını tek istekte tarar.

Parametreler:

domain: Sorgulanacak alan adı (örn. example.com)

Örnek cURL:
curl -s "https://gugu.tr/api/v1/tools/domain-scan?domain=example.com"
GET/api/v1/tools/blacklist/ip?ip=1.2.3.4

IP Kara Liste Sorgusu

IPv4 veya IPv6 adresini 20'den fazla DNSBL/RBL kara listesinde kontrol eder.

Parametreler:

ip: Kontrol edilecek IP adresi (örn. 1.2.3.4)

Örnek cURL:
curl -s "https://gugu.tr/api/v1/tools/blacklist/ip?ip=1.2.3.4"

HTTP Yanıt Kodları

200 OK — Sorgulama başarılı; JSON sonuç nesnesi döner.
400 Bad Request — Eksik ya da hatalı sorgu parametresi.
429 Too Many Requests — IP için saatlik araç limiti (60 istek) doldu.