Développeurs et API

Référence de l’API publique des outils

Gugu propose des points d’accès HTTP GET publics et gratuits pour les vérifications SPF, DKIM, DMARC, MX et de liste noire d’IP. Aucune inscription ni clé API requise.

Service gratuit et ouvert

Gratuit et ouvert

Tous les points d’accès publics des outils sont ouverts à tous. Aucune inscription préalable ni jeton d’API requis.

HTTP 429

Limites de débit

Jusqu’à 60 requêtes par heure et par IP cliente. Renvoie HTTP 429 lorsque la limite est dépassée.

60s TTL

Cache serveur

Les résultats des requêtes portant sur des cibles identiques sont mis en cache en mémoire sur le serveur pendant 60 secondes.

HTTPS

URL de base

https://gugu.tr

Points d’accès disponibles

Les points d’accès GET /api/v1/tools/* suivants renvoient directement des réponses JSON.

Ajoutez ?lang=tr, en, de, fr ou sr pour choisir la langue des résultats ; une valeur absente ou invalide renvoie le turc.

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

Vérification de l’enregistrement SPF

Interroge l’enregistrement TXT SPF du domaine, analyse la syntaxe et les mécanismes d’évaluation.

Paramètres:

domain: nom de domaine à interroger (p. ex. example.com)

Exemple cURL:

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

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

Vérification de la clé DKIM

Vérifie l’enregistrement TXT de la clé publique pour le sélecteur et le domaine indiqués.

Paramètres:

domain: nom de domaine, selector: sélecteur DKIM (p. ex. default)

Exemple cURL:

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

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

Vérification de la politique DMARC

Examine la politique DMARC, les règles d’alignement et les balises de rapport de l’enregistrement _dmarc.

Paramètres:

domain: nom de domaine à interroger (p. ex. example.com)

Exemple cURL:

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

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

Vérification de l’enregistrement BIMI

Vérifie l’enregistrement BIMI du domaine, le lien du logo et les prérequis DMARC.

Paramètres:

domain: nom de domaine à interroger (p. ex. example.com)

Exemple cURL:

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

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

Vérification du chemin de livraison MX

Liste les hôtes MX de destination, l’ordre de priorité, les adresses IP résolues et les informations sur le fournisseur.

Paramètres:

domain: nom de domaine à interroger (p. ex. example.com)

Exemple cURL:

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

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

Analyse de domaine

Analyse les enregistrements SPF, DMARC, MX, BIMI, MTA-STS et TLS-RPT en une seule requête.

Paramètres:

domain: nom de domaine à interroger (p. ex. example.com)

Exemple 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

Recherche en liste noire d’IP

Vérifie une adresse IPv4 ou IPv6 sur plus de 20 listes de spam DNSBL/RBL.

Paramètres:

ip: adresse IP à vérifier (p. ex. 1.2.3.4)

Exemple cURL:

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

Codes de réponse HTTP

200 OK — Inspection réussie, renvoie l’objet JSON du résultat.

400 Bad Request — Paramètre de requête manquant ou invalide.

429 Too Many Requests — Limite horaire (60 requêtes) dépassée pour cette IP.