Programeri i API

Referenca javnog API-ja alata

Gugu nudi besplatne, javne HTTP GET endpointe za SPF, DKIM, DMARC, MX i provere IP crnih lista. Nije potrebna registracija ni API ključ.

Besplatna i otvorena usluga

Besplatno i otvoreno

Svi javni endpointi alata otvoreni su za sve. Nije potrebna prethodna prijava ni API tokeni.

HTTP 429

Ograničenja učestalosti

Do 60 zahteva na sat po IP adresi klijenta. Kada se ograničenje premaši, vraća se HTTP 429.

60s TTL

Keširanje na serveru

Rezultati upita za iste ciljeve čuvaju se u memoriji servera 60 sekundi.

HTTPS

Osnovni URL

https://gugu.tr

Dostupni endpointi

Sledeći GET /api/v1/tools/* endpointi direktno vraćaju JSON odgovore.

Dodajte ?lang=tr, en, de, fr ili sr za jezik nalaza; ako vrednost nedostaje ili nije važeća, vraća se turski.

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

Provera SPF zapisa

Upituje SPF TXT zapis za domen, analizira sintaksu i mehanizme procene.

Parametri:

domain: ime domena za upit (npr. example.com)

cURL primer:

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

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

Provera DKIM ključa

Proverava TXT zapis javnog ključa za navedeni selektor i domen.

Parametri:

domain: ime domena, selector: DKIM selektor (npr. default)

cURL primer:

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

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

Provera DMARC politike

Pregleda DMARC politiku, pravila usklađenosti i oznake izveštavanja iz _dmarc zapisa.

Parametri:

domain: ime domena za upit (npr. example.com)

cURL primer:

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

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

Provera BIMI zapisa

Proverava BIMI zapis domena, link ka logotipu i DMARC zahteve.

Parametri:

domain: ime domena za upit (npr. example.com)

cURL primer:

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

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

Provera MX putanje isporuke

Navodi odredišta MX hostova, redosled prioriteta, razrešene IP adrese i podatke o provajderu.

Parametri:

domain: ime domena za upit (npr. example.com)

cURL primer:

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

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

Skeniranje domena

Skenira SPF, DMARC, MX, BIMI, MTA-STS i TLS-RPT zapise jednim zahtevom.

Parametri:

domain: ime domena za upit (npr. example.com)

cURL primer:

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

GET/api/v1/tools/blacklist/ip?ip=1.2.3.4

Pretraga IP crnih lista

Proverava IPv4 ili IPv6 adresu na preko 20 DNSBL/RBL spam lista.

Parametri:

ip: IP adresa za proveru (npr. 1.2.3.4)

cURL primer:

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

HTTP kodovi odgovora

200 OK — Uspešna provera, vraća JSON objekat sa rezultatom.

400 Bad Request — Nedostaje ili je neispravan parametar upita.

429 Too Many Requests — Premašeno je časovno ograničenje (60 zahteva) za ovu IP adresu.