Mehr Prüfungen mit einem API-Schlüssel

Jede Prüfung zählt eins, auch im Stapel und bei der Domain-Prüfung. Die Werte stammen aus der Konfiguration des Dienstes und gelten als Standard.

Was ein Schlüssel kann

• Höheres Minutenlimit: 60 (Pro) oder 300 (Business) Prüfungen pro Minute statt 10.
• Kein Tageslimit, dafür ein Monatskontingent von 10.000 (Pro) oder 100.000 (Business) Prüfungen.
• Die Domain-Prüfung für Listen, WordPress-Plugin und Formular-Einbau läuft mit denselben Limits. Mehr dazu unter Integrationen.
• Abfrage des eigenen Stands über GET /api/v1/schluessel: Stufe, Limits und im laufenden Monat verbrauchte Prüfungen.

So senden Sie den Schlüssel

Der Schlüssel beginnt mit mc_ und gehört in den Header X-API-Key. Alternativ akzeptiert mailcheck Authorization: Bearer mc_…. Als Parameter in der URL wird der Schlüssel abgelehnt (Status 400), damit er nicht in Protokollen landet. Setzen Sie ihn möglichst nur auf Ihrem Server ein. Steht ein Schlüssel im Code, der im Browser Ihrer Besucher läuft (etwa im Formular-Widget), ist er öffentlich sichtbar. Nutzen Sie dafür nur einen eigens ausgestellten, sperrbaren Schlüssel und nie den Ihres Servers.

curl -s -X POST https://mailcheck.moersbergerit.de/api/v1/pruefen \
  -H "X-API-Key: mc_IHR_SCHLUESSEL" \
  -H "Content-Type: application/json" \
  -d '{"email": "name@beispiel.de"}'

const antwort = await fetch("https://mailcheck.moersbergerit.de/api/v1/pruefen", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.MAILCHECK_KEY,   // nur serverseitig, im Browser wäre er öffentlich
  },
  body: JSON.stringify({ email: "name@beispiel.de" }),
});
if (antwort.status === 429) {
  console.log("Wartezeit in Sekunden:", antwort.headers.get("Retry-After"));
}
const daten = await antwort.json();

<?php
$ch = curl_init("https://mailcheck.moersbergerit.de/api/v1/pruefen");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "X-API-Key: " . getenv("MAILCHECK_KEY"),
    ],
    CURLOPT_POSTFIELDS => json_encode(["email" => "name@beispiel.de"]),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
]);
$body = curl_exec($ch);
curl_close($ch);

Fehler und Header stehen in der API-Dokumentation.

Wenn das Kontingent aufgebraucht ist

Ist das Monatskontingent erschöpft, antwortet die API mit Status 429 und dem Code kontingent_erschoepft. Der Header Retry-After nennt die Sekunden bis zum Monatsanfang. Ein ungültiger oder gesperrter Schlüssel liefert 401 mit schluessel_ungueltig, ohne Hinweis, welcher Fall vorliegt. Jede Antwort mit Schlüssel trägt außerdem X-Kontingent-Monat und X-Kontingent-Rest.

Datenschutz

• Geprüfte Adressen werden nicht gespeichert und nicht protokolliert, mit und ohne Schlüssel.
• Vom Schlüssel selbst speichert mailcheck nur eine Prüfsumme (SHA-256) und die ersten Zeichen zur Anzeige. Den Klartext sehen Sie einmal bei der Ausgabe.
• Zum Schlüssel gehören Ihre Kontaktadresse für Rückfragen und eine Zahl: wie viele Prüfungen im Monat gezählt wurden. Keine Adressen, keine Inhalte.
• Die Kontaktadresse ist nicht öffentlich. Details in der Datenschutzerklärung.

Schlüssel anfragen

Preis auf Anfrage. Schreiben Sie eine kurze E-Mail mit der gewünschten Stufe und dem Verwendungszweck, mailcheck antwortet per E-Mail. Der Knopf öffnet Ihr Mailprogramm mit einer Textvorlage.

Schlüssel anfragen

Oder direkt an kontakt@moersbergerit.de. Bis dahin können Sie mailcheck wie bisher ohne Schlüssel nutzen, siehe API-Dokumentation.