MailAuditby HelloWP
API dokumentacija

API nuoroda

Integruokite MailAudit paslaugas į savo programą. Nemokama API prieiga MX įrašų ir juodųjų sąrašų tikrinimui.

API rakto nereikia

Galite naudoti iškart, be registracijos

Užklausų limitas

60 užklausų / minutę / IP adresą

Bazinis URL

https://api.mailaudit.io

Endpoint’ai

MX įrašų patikra

GET/tools/mx-check

Užklausti domeno MX įrašus bei SPF ir DMARC nustatymus.

Parametrai

domainstringprivaloma
Domeno vardas, kurį tikrinsime (pvz. example.com)

Užklausos pavyzdys

bash
curl "https://api.mailaudit.io/tools/mx-check?domain=gmail.com"

Atsakymo pavyzdys

json
1{
2  "domain": "gmail.com",
3  "hasMx": true,
4  "records": [
5    {
6      "exchange": "gmail-smtp-in.l.google.com",
7      "priority": 5,
8      "ip": ["142.250.150.27"]
9    },
10    {
11      "exchange": "alt1.gmail-smtp-in.l.google.com",
12      "priority": 10,
13      "ip": ["142.250.141.26"]
14    }
15  ],
16  "hasSpf": true,
17  "spfRecord": "v=spf1 redirect=_spf.google.com",
18  "hasDmarc": true,
19  "dmarcRecord": "v=DMARC1; p=none; sp=quarantine; rua=mailto:..."
20}

Juodųjų sąrašų patikra

GET/tools/blacklist-check

Patikrinti, ar IP adresas arba domenas yra pagrindiniuose šlamšto blokavimo sąrašuose (23+ DNSBL).

Parametrai

querystringprivaloma
IP adresas (pvz. 192.168.1.1) arba domeno vardas

Užklausos pavyzdys

bash
curl "https://api.mailaudit.io/tools/blacklist-check?query=8.8.8.8"

Atsakymo pavyzdys

json
1{
2  "query": "8.8.8.8",
3  "queryType": "ip",
4  "totalChecked": 23,
5  "totalListed": 0,
6  "results": [
7    {
8      "name": "Spamhaus ZEN",
9      "zone": "zen.spamhaus.org",
10      "listed": false,
11      "responseTime": 45
12    },
13    {
14      "name": "Barracuda",
15      "zone": "b.barracudacentral.org",
16      "listed": false,
17      "responseTime": 32
18    }
19    // ...
20  ]
21}

Domeno reputacijos patikra

GET/tools/reputation

Išsamus domeno reputacijos balo skaičiavimas. Tikriname SPF, DKIM, DMARC, MX įrašus, juodųjų sąrašų būseną, STARTTLS palaikymą, domeno amžių ir reverse DNS.

Parametrai

domainstringprivaloma
Domeno vardas, kurį tikrinsime (pvz. gmail.com)

Užklausos pavyzdys

bash
curl "https://api.mailaudit.io/tools/reputation?domain=gmail.com"
Vertinimo skalė
90-100 = A+
80-89 = A
70-79 = B
60-69 = C
50-59 = D
0-49 = F

Atsakymo pavyzdys

json
1{
2  "domain": "gmail.com",
3  "ip": "142.250.150.27",
4  "score": 100,
5  "grade": "A+",
6  "factors": [
7    { "name": "SPF", "status": "pass", "detail": "Policy: present", "impact": 15 },
8    { "name": "DKIM", "status": "warn", "detail": "Not found", "impact": 0 },
9    { "name": "DMARC", "status": "warn", "detail": "Policy: none", "impact": 5 },
10    { "name": "MX Records", "status": "pass", "detail": "5 record(s)", "impact": 10 },
11    { "name": "Blacklists", "status": "pass", "detail": "Clean (10 checked)", "impact": 20 },
12    { "name": "STARTTLS", "status": "pass", "detail": "Supported", "impact": 10 },
13    { "name": "Domain Age", "status": "pass", "detail": "30.3 years", "impact": 10 },
14    { "name": "Reverse DNS", "status": "pass", "detail": "wa-in-f27.1e100.net", "impact": 5 }
15  ],
16  "details": {
17    "mx": { "valid": true, "count": 5, "primary": "gmail-smtp-in.l.google.com" },
18    "spf": { "valid": true, "record": "v=spf1 redirect=_spf.google.com" },
19    "dkim": { "valid": false, "selectors": [] },
20    "dmarc": { "valid": true, "policy": "none", "rua": ["mailto:..."] },
21    "blacklists": { "checked": 10, "listed": 0, "clean": true },
22    "tls": { "valid": true, "starttls": true },
23    "domainAge": { "valid": true, "years": 30.3, "registrationDate": "1995-08-13" },
24    "rdns": { "valid": true, "hostname": "wa-in-f27.1e100.net" }
25  },
26  "checkedAt": "2025-12-03T07:05:46.232Z",
27  "cached": false
28}

HTTP būsenos kodai

KodasBūsenaAprašymas
200OKUžklausa sėkminga
400Bad RequestTrūksta arba neteisingas parametras
429Too Many RequestsViršytas užklausų limitas (60/min.)
500Internal Server ErrorServerio klaida

Klaidų atsakymai

Klaidos atveju atsakyme bus pateiktas error laukas su klaidos aprašymu:

json
{
  "error": "Reikalingas domenas"
}

Kodo pavyzdžiai

JavaScript / Node.js

javascript
1// Užklausti MX įrašus
2const response = await fetch(
3  'https://api.mailaudit.io/tools/mx-check?domain=example.com'
4);
5const data = await response.json();
6
7if (data.hasMx) {
8  console.log('MX įrašai:', data.records);
9  console.log('SPF:', data.hasSpf ? data.spfRecord : 'Nėra');
10  console.log('DMARC:', data.hasDmarc ? data.dmarcRecord : 'Nėra');
11}

Python

python
1import requests
2
3# Juodųjų sąrašų patikra
4response = requests.get(
5    'https://api.mailaudit.io/tools/blacklist-check',
6    params={'query': '192.168.1.1'}
7)
8data = response.json()
9
10print(f"Patikrinta: {data['totalChecked']} sąrašų")
11print(f"Įtraukta į: {data['totalListed']} vietų")
12
13for result in data['results']:
14    if result['listed']:
15        print(f"⚠️  {result['name']}: SĄRAŠE")

Python - Reputation Check

python
1import requests
2
3# Domeno reputacijos patikra
4response = requests.get(
5    'https://api.mailaudit.io/tools/reputation',
6    params={'domain': 'example.com'}
7)
8data = response.json()
9
10print(f"Score: {data['score']}/100 ({data['grade']})")
11print("\nVeiksniai:")
12for factor in data['factors']:
13    icon = "✅" if factor['status'] == 'pass' else "⚠️" if factor['status'] == 'warn' else "❌"
14    print(f"  {icon} {factor['name']}: {factor['detail']} ({factor['impact']:+d})")

PHP

php
1<?php
2// MX patikra
3$domain = 'example.com';
4$url = "https://api.mailaudit.io/tools/mx-check?domain=" . urlencode($domain);
5
6$response = file_get_contents($url);
7$data = json_decode($response, true);
8
9if ($data['hasMx']) {
10    foreach ($data['records'] as $mx) {
11        echo "MX: {$mx['exchange']} (prioritetas: {$mx['priority']})\n";
12    }
13}
14?>

Norite išbandyti API?

Išbandykite mūsų įrankius žiniatinklyje arba pradėkite kurti integraciją su API.

MX tikrinimasJuodųjų sąrašų tikrinimasReputacijos patikra