API dokumentācija

API atsauce

Integrējiet MailAudit savā lietotnē. Bezmaksas API pieeja MX ierakstu un melno sarakstu pārbaudēm.

Nav API atslēgas

Var lietot uzreiz, bez reģistrācijas

Pieprasījumu limits

60 pieprasījumi / minūtē / IP adrese

Bāzes URL

https://api.mailaudit.io

Gala punkti (Endpoints)

MX ierakstu pārbaude

GET/tools/mx-check

Vaicāt domēna MX ierakstiem, kā arī SPF un DMARC iestatījumiem.

Parametri

domainstringobligāts

Pārbaudāmais domēna nosaukums (piem., example.com)

Pieprasījuma piemērs

bash

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

Atbildes piemērs

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}

Melnā saraksta pārbaude

GET/tools/blacklist-check

Pārbaudīt, vai IP adrese vai domēns atrodas lielākajos spama bloķēšanas sarakstos (23+ DNSBL).

Parametri

querystringobligāts

IP adrese (piem., 192.168.1.1) vai domēna nosaukums

Pieprasījuma piemērs

bash

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

Atbildes piemērs

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}

Domēna reputācijas pārbaude

GET/tools/reputation

Visaptverošs domēna reputācijas vērtējums. Pārbauda SPF, DKIM, DMARC, MX ierakstus, melnos sarakstus, STARTTLS atbalstu, domēna vecumu un reverse DNS.

Parametri

domainstringobligāts

Pārbaudāmais domēna nosaukums (piem., gmail.com)

Pieprasījuma piemērs

bash

curl "https://api.mailaudit.io/tools/reputation?domain=gmail.com"

Vērtēšanas skala

90-100 = A+

80-89 = A

70-79 = B

60-69 = C

50-59 = D

0-49 = F

Atbildes piemērs

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 statusa kodi

Kods	Statuss	Apraksts
200	OK	Pieprasījums izdevies
400	Bad Request	Trūkst vai ir nederīgs parametrs
429	Too Many Requests	Pārsniegts limits (60/minūtē)
500	Internal Server Error	Servera kļūda

Kļūdu atbildes

Kļūdas gadījumā atbildē ir lauks error ar kļūdas aprakstu:

json

{
  "error": "Nepieciešams domēns"
}

Koda piemēri

JavaScript / Node.js

javascript

1// Vaicāt MX ierakstus
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 ieraksti:', data.records);
9  console.log('SPF:', data.hasSpf ? data.spfRecord : 'Nav');
10  console.log('DMARC:', data.hasDmarc ? data.dmarcRecord : 'Nav');
11}

Python

python

1import requests
2
3# Melnā saraksta pārbaude
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"Pārbaudīti: {data['totalChecked']} saraksti")
11print(f"Ierakstīts: {data['totalListed']} reizes")
12
13for result in data['results']:
14    if result['listed']:
15        print(f"⚠️  {result['name']}: IERAKSTĪTS")

Python - Reputation Check

python

1import requests
2
3# Domēna reputācijas pārbaude
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("\nFaktori:")
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 pārbaude
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']} (prioritāte: {$mx['priority']})\n";
12    }
13}
14?>

Vēlaties izmēģināt API?

Izmēģiniet mūsu rīkus tīmekļa saskarnē vai sāciet izstrādi ar API.

MX testers Melnā saraksta pārbaude Reputācijas pārbaude