Entwickler & API

Referenz der öffentlichen Tools-API

Gugu bietet kostenlose, öffentliche HTTP-GET-Endpunkte für SPF-, DKIM-, DMARC-, MX- und IP-Blacklist-Prüfungen. Keine Registrierung und kein API-Schlüssel nötig.

Kostenloser & offener Dienst

Kostenlos & offen

Alle öffentlichen Tool-Endpunkte stehen jedem offen. Keine vorherige Anmeldung und keine API-Tokens erforderlich.

HTTP 429

Ratenlimits

Bis zu 60 Anfragen pro Stunde und Client-IP. Bei Überschreitung des Limits wird HTTP 429 zurückgegeben.

60s TTL

Server-Caching

Abfrageergebnisse für identische Ziele werden 60 Sekunden lang im Arbeitsspeicher des Servers zwischengespeichert.

HTTPS

Basis-URL

https://gugu.tr

Verfügbare Endpunkte

Die folgenden GET-Endpunkte unter /api/v1/tools/* liefern direkt JSON-Antworten.

Fügen Sie ?lang=tr, en, de, fr oder sr für die Sprache der Befunde hinzu; bei fehlendem oder ungültigem Wert wird Türkisch zurückgegeben.

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

SPF-Eintrag prüfen

Fragt den SPF-TXT-Eintrag der Domain ab und analysiert Syntax und Auswertungsmechanismen.

Parameter:

domain: Abzufragender Domainname (z. B. example.com)

cURL-Beispiel:

curl -s "https://gugu.tr/api/v1/tools/spf?domain=example.com"

GET/api/v1/tools/dkim?domain=example.com&selector=default

DKIM-Schlüssel prüfen

Verifiziert den TXT-Eintrag mit dem öffentlichen Schlüssel für den angegebenen Selector und die Domain.

Parameter:

domain: Domainname, selector: DKIM-Selector (z. B. default)

cURL-Beispiel:

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

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

DMARC-Richtlinie prüfen

Untersucht die DMARC-Richtlinie, Alignment-Regeln und Berichts-Tags aus dem _dmarc-Eintrag.

Parameter:

domain: Abzufragender Domainname (z. B. example.com)

cURL-Beispiel:

curl -s "https://gugu.tr/api/v1/tools/dmarc?domain=example.com"

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

BIMI-Eintrag prüfen

Prüft den BIMI-Eintrag der Domain, den Logo-Link und die DMARC-Anforderungen.

Parameter:

domain: Abzufragender Domainname (z. B. example.com)

cURL-Beispiel:

curl -s "https://gugu.tr/api/v1/tools/bimi?domain=example.com"

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

MX-Zustellweg prüfen

Listet MX-Hosts, Prioritätsreihenfolge, aufgelöste IP-Adressen und Anbieterinformationen auf.

Parameter:

domain: Abzufragender Domainname (z. B. example.com)

cURL-Beispiel:

curl -s "https://gugu.tr/api/v1/tools/mx?domain=example.com"

GET/api/v1/tools/domain-scan?domain=example.com

Domain-Scan

Scannt SPF-, DMARC-, MX-, BIMI-, MTA-STS- und TLS-RPT-Einträge in einer einzigen Anfrage.

Parameter:

domain: Abzufragender Domainname (z. B. example.com)

cURL-Beispiel:

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-Blacklist-Abfrage

Prüft eine IPv4- oder IPv6-Adresse in über 20 DNSBL/RBL-Spam-Listen.

Parameter:

ip: Zu prüfende IP-Adresse (z. B. 1.2.3.4)

cURL-Beispiel:

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

HTTP-Antwortcodes

200 OK — Erfolgreiche Prüfung, gibt ein JSON-Ergebnisobjekt zurück.

400 Bad Request — Fehlender oder ungültiger Abfrageparameter.

429 Too Many Requests — Stündliches Ratenlimit (60 Anfragen) für diese IP überschritten.