API-Endpunkt-Referenz

GET /api/v1/dns-check

Führt eine umfassende DNS-Abfrage für eine Domain durch und gibt A-, AAAA-, MX-, TXT-, CNAME- und NS-Records zurück.

Parameter

Parameter	Typ	Pflicht	Beschreibung
domain	string	✅	Zu prüfende Domain (z.B. example.com)

Beispiel-Anfrage

curl -H "Authorization: Bearer pt_..." \
  "https://provider.tools/api/v1/dns-check?domain=example.com"

Beispiel-Antwort

{
  "success": true,
  "data": {
    "domain": "example.com",
    "a": ["93.184.216.34"],
    "aaaa": ["2606:2800:220:1:248:1893:25c8:1946"],
    "mx": [{"exchange": "mail.example.com", "priority": 10}],
    "txt": ["v=spf1 include:_spf.google.com ~all"],
    "cname": [],
    "ns": ["ns1.example.com", "ns2.example.com"]
  }
}

GET /api/v1/ssl-check

Ruft das SSL/TLS-Zertifikat einer Domain ab und analysiert es — einschließlich Gültigkeit, Ablauf, Aussteller und Verschlüsselungsdetails.

Parameter

Parameter	Typ	Pflicht	Beschreibung
domain	string	✅	Zu prüfende Domain (z.B. example.com)

Beispiel-Anfrage

curl -H "Authorization: Bearer pt_..." \
  "https://provider.tools/api/v1/ssl-check?domain=example.com"

Beispiel-Antwort

{
  "success": true,
  "data": {
    "domain": "example.com",
    "subject": {"CN": "example.com"},
    "issuer": {"O": "Let's Encrypt", "CN": "R3"},
    "validFrom": "2024-01-01T00:00:00.000Z",
    "validTo": "2024-04-01T00:00:00.000Z",
    "daysRemaining": 42,
    "isExpired": false,
    "serialNumber": "03:AB:CD:EF:...",
    "subjectAltNames": ["example.com", "www.example.com"],
    "protocol": "TLSv1.3",
    "cipher": {"name": "TLS_AES_256_GCM_SHA384", "version": "TLSv1.3"}
  }
}

GET /api/v1/blacklist-check

Prüft eine IPv4-Adresse gegen 80+ DNS-basierte Blacklists (DNSBLs) und zeigt den Listing-Status an.

Parameter

Parameter	Typ	Pflicht	Beschreibung
ip	string	✅	IPv4-Adresse (z.B. 1.2.3.4)

Beispiel-Anfrage

curl -H "Authorization: Bearer pt_..." \
  "https://provider.tools/api/v1/blacklist-check?ip=1.2.3.4"

Beispiel-Antwort

{
  "success": true,
  "data": {
    "ip": "1.2.3.4",
    "totalChecked": 84,
    "listedCount": 2,
    "cleanCount": 82,
    "blacklists": [
      {"name": "Spamhaus SBL", "dnsbl": "sbl.spamhaus.org", "listed": true, "category": "critical"},
      {"name": "Barracuda", "dnsbl": "b.barracudacentral.org", "listed": true, "category": "major"},
      {"name": "SpamCop", "dnsbl": "bl.spamcop.net", "listed": false, "category": "critical"},
      ...
    ]
  }
}

GET /api/v1/dmarc-check

Validiert die DMARC-, SPF- und DKIM-DNS-Records einer Domain. Prüft automatisch gängige DKIM-Selektoren.

Parameter

Parameter	Typ	Pflicht	Beschreibung
domain	string	✅	Zu prüfende Domain (z.B. example.com)

Beispiel-Anfrage

curl -H "Authorization: Bearer pt_..." \
  "https://provider.tools/api/v1/dmarc-check?domain=example.com"

Beispiel-Antwort

{
  "success": true,
  "data": {
    "domain": "example.com",
    "dmarc": {
      "found": true,
      "record": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com; pct=100",
      "tags": {"v": "DMARC1", "p": "quarantine", "rua": "mailto:dmarc@example.com", "pct": "100"}
    },
    "spf": {
      "found": true,
      "record": "v=spf1 include:_spf.google.com ~all"
    },
    "dkim": [
      {"selector": "google", "found": true, "record": "v=DKIM1; k=rsa; p=MIIBIj..."}
    ]
  }
}

GET /api/v1/dmarc/domains

Listet alle in Ihrem Konto konfigurierten DMARC-Domains auf.

Beispiel-Antwort

{
  "success": true,
  "data": [
    {
      "id": "abc-123",
      "domain": "example.com",
      "verified": true,
      "reportEmail": "dmarc-rua@provider.tools",
      "totalReports": 42,
      "lastReportAt": "2025-01-15T10:30:00.000Z",
      "createdAt": "2024-06-01T00:00:00.000Z"
    }
  ]
}

GET /api/v1/dmarc/domains/:domainId/reports

Ruft paginierte DMARC-Aggregate-Reports für eine bestimmte Domain ab.

Parameter

Parameter	Typ	Pflicht	Beschreibung
:domainId	Pfad	✅	Domain-ID aus der Domains-Liste
page	Query	❌	Seitennummer (Standard: 1)
limit	Query	❌	Einträge pro Seite (Standard: 20, max: 100)

GET /api/v1/monitoring/hosts

Listet alle überwachten Hosts/IPs aus Ihrem Blacklist-Monitoring auf.

Beispiel-Antwort

{
  "success": true,
  "data": [
    {
      "id": "def-456",
      "host": "mail.example.com",
      "label": "Primary MX",
      "status": "clean",
      "listedCount": 0,
      "totalChecked": 84,
      "lastCheckAt": "2025-01-15T12:00:00.000Z"
    }
  ]
}

GET /api/v1/delisting/status

Listet Ihre aktiven und abgeschlossenen Delisting-Prozesse mit detaillierten Schritt-Informationen pro Blacklist.

Parameter

Parameter	Typ	Pflicht	Beschreibung
ip	Query	Nein	Nach IP-Adresse filtern
status	Query	Nein	Filter: pending, in-progress, completed, failed
page	Query	Nein	Seitennummer (Standard: 1)
limit	Query	Nein	Einträge pro Seite (Standard: 20, max: 100)

Beispiel-Anfrage

curl -H "Authorization: Bearer pt_..." \
  "https://provider.tools/api/v1/delisting/status?ip=1.2.3.4"

Beispiel-Antwort

{
  "success": true,
  "data": {
    "processes": [{
      "id": "abc-123",
      "ip": "1.2.3.4",
      "status": "in-progress",
      "totalListings": 3,
      "stepsCompleted": 1,
      "stepsRunning": 2,
      "steps": [
        {"blacklistName": "Spamhaus SBL", "dnsbl": "sbl.spamhaus.org", "method": "automatic", "status": "completed"},
        {"blacklistName": "Barracuda", "dnsbl": "b.barracudacentral.org", "method": "email", "status": "waiting"}
      ]
    }],
    "pagination": {"page": 1, "total": 1, "totalPages": 1}
  }
}

Step-Status-Werte

Status	Beschreibung
pending	Noch nicht gestartet
running	KI-Agent arbeitet aktiv
email-sent	Delisting-E-Mail gesendet
waiting	Wartet auf Antwort
completed	Erfolgreich delistet
failed	Delisting fehlgeschlagen