Die beste Verifizierungs-API ist die, die unter Last funktioniert.

Sie werden jahrelang auf dieses Objekt verzweigen, lesen Sie es also vor allem anderen. Ein Schema mit einem einzigen Aufzählungsfeld zwingt jeden Konsumenten, die Feinheit neu herzuleiten, die der Anbieter bereits hatte und weggeworfen hat.

Sie wollen ein Urteil, auf das Sie schalten können, einen numerischen Score, dessen Schwelle Sie selbst setzen, und maschinenlesbare Gründe unter beidem. Diese Gründe erlauben es, eine Rollenadresse anders zu behandeln als ein volles Postfach und anders als eine Domain, die Sie ins Greylisting gesetzt hat, ohne drei getrennte Integrationen.

• Ein über Versionen stabiles Erreichbarkeitsurteil, das sauber auf erlauben, warnen und blockieren abbildet
• Ein Score, damit Ihre Schwelle ein Konfigurationswert ist und keine Anbieterentscheidung
• Dokumentierte, aufzählbare Begründungscodes, kein englischer Freitext
• Eine empfohlene Aktion, nützlich für die Teile des Produkts, die kein Code sind
• Kennzeichen für die Bedingungen, die Sie interessieren: Catch-all, Wegwerfadresse, Rolle, Tippfehlervorschläge

Verifizierung auf Postfachebene spricht per SMTP mit einem Dritten, und manche Zielserver sind absichtlich langsam. Eine Einzelprüfung ist meist schnell und gelegentlich nicht, was ein Problem ist, wenn sie im kritischen Pfad einer Registrierung sitzt.

Planen Sie dafür, statt zu hoffen. Setzen Sie ein Client-Timeout, das Sie einem Nutzer zumuten wollen, behandeln Sie das Erreichen als unklar und nicht als ungültig, und lassen Sie die Anmeldung mit einer Markierung durch, statt einen echten Kunden abzuweisen, weil ein Mailserver beschäftigt war. Prüfen Sie danach asynchron nach und handeln Sie nach der zweiten Antwort.

Fragen Sie jeden Anbieter nach dem veröffentlichten Timeout und dem Verhalten beim Erreichen. Wer beim eigenen Timeout ungültig liefert, verwandelt still sein Infrastrukturproblem in Ihre verlorene Anmeldung.

Es gibt drei Arten von Fehlern und sie verlangen drei verschiedene Reaktionen von Ihrem Code. Sie zu verwechseln ist die häufigste Ursache dafür, dass eine Verifizierungsintegration in Produktion schiefgeht.

Eine fehlerhafte Anfrage ist Ihr Bug und darf nie wiederholt werden. Eine Ratenbegrenzung oder ein vorübergehender Ausfall stromaufwärts gehört mit wachsender Wartezeit wiederholt. Und ein unklares Urteil ist überhaupt kein Fehler: Der Aufruf war erfolgreich, die Antwort lautet, dass keine Antwort verfügbar war, und sofort zu wiederholen liefert dieselbe Nichtantwort und kostet einen weiteren Credit.

• 4xx für Ihre Fehler, mit einem stabilen maschinenlesbaren Code, keinem Satz
• 429 mit einem Header, der sagt, wann Sie wiederkommen sollen, statt einer nackten Absage
• 5xx nur für die Ausfälle des Anbieters, damit Ihr Monitoring sich darauf verlassen kann
• Unklare Ergebnisse als 200 mit dem Urteil unbekannt, weil genau das passiert ist

Eine Einzelprüfung ist synchron und lebt in einer Anfrage. Ein Massenlauf ist asynchron und lebt in einer Warteschlange, manchmal eine Stunde lang. Das zweite wie das erste zu behandeln endet damit, dass man vierzig Minuten lang jede Sekunde einen Status abfragt.

Prüfen Sie, ob die Massenseite eine echte Job-API ist: einreichen, ID erhalten, abfragen oder Rückruf empfangen, dann herunterladen. Prüfen Sie, was passiert, wenn Sie dieselbe Datei zweimal einreichen, wo die Größengrenze liegt und ob der Export Ihre eigenen Spalten behält. Diese drei Antworten sparen mehr Entwicklungszeit als der Preisunterschied zwischen zwei beliebigen Anbietern dieses Marktes.

Keines davon ist interessant bis zu dem Tag, an dem es das ist, und dann ist die Integration längst geschrieben.

• Schlüsselrotation. Mehr als ein aktiver Schlüssel, einzeln widerrufbar, ohne Ausfall.
• Rufen Sie eine Verifizierungs-API niemals aus dem Browser auf. Der Schlüssel ist ein Geheimnis, und ein öffentlicher Schlüssel ist das Guthaben von jemand anderem.
• Speicherung. Wie lange die gesendete Adresse aufbewahrt wird und ob Sie das verkürzen können.
• Idempotenz beim Einreichen eines Massenlaufs, damit ein Netzwerkaussetzer nicht dieselbe Datei zweimal abrechnet.
• Ob dieselbe Engine hinter Dashboard und API steht. Sonst beweist Ihre Stichprobe nichts über die Produktion.

Ein Token, ein Endpunkt für eine Adresse und einer für einen Stapel. POST /v1/check_email liefert Urteil, Score, Begründungscodes und empfohlene Aktion; POST /v1/bulk nimmt eine Liste und liefert einen Job zum Abfragen. Beide sind mit ausführbaren Beispielen dokumentiert statt mit einem Schema-Abzug.

API-Schlüssel gehören zu jedem bezahlten Tarif, monatlich oder nach Bedarf, statt bei einer Stufe zu beginnen, die die meisten Teams nicht brauchen. Ein kostenloses Konto prüft im Dashboard, was reicht, um die Form der Antwort vor dem ersten Code zu sehen.