MailAuditby HelloWP
Dokumentacja API

Referencja API

Zintegruj usługi MailAudit z własną aplikacją. Darmowy dostęp do API dla sprawdzania rekordów MX i blacklist.

Bez klucza API

Gotowe do użycia, bez rejestracji

Limit zapytań

60 zapytań / minutę / adres IP

Bazowy URL

https://api.mailaudit.io

Endpointy

Sprawdzenie rekordu MX

GET/tools/mx-check

Zapytanie o rekordy MX domeny oraz ustawienia SPF i DMARC.

Parametry

domainstringwymagany
Nazwa domeny do sprawdzenia (np. example.com)

Przykładowe zapytanie

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

Przykład odpowiedzi

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}

Sprawdzenie blacklist

GET/tools/blacklist-check

Sprawdź, czy adres IP lub domena znajduje się na głównych listach blokujących spam (23+ DNSBL).

Parametry

querystringwymagany
Adres IP (np. 192.168.1.1) lub nazwa domeny

Przykładowe zapytanie

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

Przykład odpowiedzi

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}

Sprawdzenie reputacji domeny

GET/tools/reputation

Kompleksowe wyliczenie wyniku reputacji domeny. Sprawdza SPF, DKIM, DMARC, rekordy MX, status blacklist, wsparcie STARTTLS, wiek domeny oraz reverse DNS.

Parametry

domainstringwymagany
Nazwa domeny do sprawdzenia (np. gmail.com)

Przykładowe zapytanie

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

Przykład odpowiedzi

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}

Kody statusu HTTP

KodStatusOpis
200OKZapytanie zakończone powodzeniem
400Bad RequestBrak lub nieprawidłowy parametr
429Too Many RequestsPrzekroczony limit zapytań (60/minutę)
500Internal Server ErrorBłąd po stronie serwera

Odpowiedzi błędów

W przypadku błędu odpowiedź zawiera pole error z opisem błędu:

json
{
  "error": "Domain is required"
}

Przykłady kodu

JavaScript / Node.js

javascript
1// Zapytanie o rekordy MX
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('Rekordy MX:', data.records);
9  console.log('SPF:', data.hasSpf ? data.spfRecord : 'Brak');
10  console.log('DMARC:', data.hasDmarc ? data.dmarcRecord : 'Brak');
11}

Python

python
1import requests
2
3# Sprawdzenie blacklist
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"Sprawdzono: {data['totalChecked']} list")
11print(f"Na listach: {data['totalListed']} wpisów")
12
13for result in data['results']:
14    if result['listed']:
15        print(f"⚠️  {result['name']}: LISTED")

Python - Reputation Check

python
1import requests
2
3# Sprawdzenie reputacji domeny
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("\nCzynniki:")
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// Sprawdzenie MX
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']} (priorytet: {$mx['priority']})\n";
12    }
13}
14?>

Chcesz wypróbować API?

Przetestuj nasze narzędzia w interfejsie webowym lub zacznij integrację z API.

Tester MXChecker blacklistSprawdzenie reputacji