API-Übersicht & Authentifizierung

Die provider.tools REST API bietet programmatischen Zugang zu allen Kerntools: DNS-Abfragen, SSL-Zertifikatsprüfungen, IP-Blacklist-Scans, DMARC-Record-Validierung und mehr. Nutzen Sie sie, um unsere Checks in Ihre eigenen Monitoring-Systeme, CI/CD-Pipelines oder individuelle Dashboards zu integrieren.

Hauptmerkmale

• RESTful JSON API — Standard-HTTP-Methoden und JSON-Antworten
• Bearer-Token-Authentifizierung — Sichere API-Tokens mit SHA-256-Hashing
• Plan-basierte Rate Limits — Anfragen skalieren mit Ihrem Abonnement
• Echtzeit-Ergebnisse — Alle Prüfungen laufen live gegen autoritative Quellen

Basis-URL

https://provider.tools/api/v1/

Verfügbarkeit nach Plan

Plan	API-Zugang	Calls/Monat
Free	❌	—
Starter	✅	1.000
Pro	✅	10.000
Business	✅	100.000
Enterprise	✅	Unbegrenzt

Alle API-Anfragen erfordern einen gültigen API-Token. Sie können Tokens in Ihren Kontoeinstellungen → API Tokens erstellen und verwalten.

Token erstellen

1. Öffnen Sie die Kontoeinstellungen im Dashboard
2. Scrollen Sie zum Abschnitt API Tokens
3. Klicken Sie auf „Neuer Token"
4. Geben Sie einen aussagekräftigen Namen ein (z.B. „CI Pipeline", „Monitoring Script")
5. Optional: Setzen Sie ein Ablaufdatum (in Tagen)
6. Kopieren Sie den Token sofort — er wird nie wieder angezeigt!

Token verwenden

Übergeben Sie Ihren Token im Authorization-Header oder im X-API-Key-Header:

# Methode 1: Authorization Bearer Header (empfohlen)
curl -H "Authorization: Bearer pt_ihr_token_hier" \
  https://provider.tools/api/v1/dns-check?domain=example.com

# Methode 2: X-API-Key Header
curl -H "X-API-Key: pt_ihr_token_hier" \
  https://provider.tools/api/v1/dns-check?domain=example.com

Token-Format

Tokens beginnen mit dem Präfix pt_ gefolgt von 48 Hexadezimalzeichen. Beispiel: pt_a1b2c3d4e5f6...

Tokens werden als SHA-256-Hashes gespeichert — wir können verlorene Tokens nicht wiederherstellen. Erstellen Sie bei Verlust einfach einen neuen.

Token-Limits

• Maximal 10 Tokens pro Konto
• Tokens können optional ein Ablaufdatum haben
• Tokens können jederzeit im Dashboard widerrufen werden

Alle API-Antworten folgen einem einheitlichen Format:

Erfolgreiche Antwort

{
  "success": true,
  "data": { ... }
}

Fehler-Antwort

{
  "success": false,
  "error": "Beschreibung des Fehlers"
}

HTTP-Statuscodes

Code	Bedeutung
200	Erfolg
400	Ungültige Anfrage — fehlende oder ungültige Parameter
401	Nicht autorisiert — ungültiger, abgelaufener oder widerrufener Token
403	Verboten — API nicht in Ihrem Plan verfügbar
404	Nicht gefunden — Ressource existiert nicht oder gehört nicht zu Ihnen
429	Rate Limit überschritten — zu viele Anfragen
500	Interner Serverfehler — bitte erneut versuchen oder Support kontaktieren