Przejdź do głównej treści
POST
/
email
/
verify
/
bulk
curl --request POST \
  --url https://api.enrow.io/email/verify/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "verifications": [
      "pam.beesly@dundermifflin.com",
      "angela.martin@dundermifflin.com",
      "stanley.hudson@dundermifflin.com"
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/verify"
    }
  }'
{
  "message": "Bulk verification operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 0.75,
  "estimated_duration": 1
}
POST
https://api.enrow.io/email/verify/bulk
Uruchom wiele weryfikacji e-maili w jednym żądaniu. Do 5000 weryfikacji na partię. Uwierzytelniaj każde żądanie za pomocą klucza API w nagłówku x-api-key. Aby zamiast tego zweryfikować pojedynczy adres, użyj punktu końcowego Verify Single Email.
Enrow wykonuje deterministyczne weryfikacje, które weryfikują nawet adresy typu catch-all. Bez potrzeby stosowania debouncera.

Request Body

verifications
array of strings
wymagane
Tablica adresów e-mail do zweryfikowania.
custom
object
Niestandardowe parametry, które zostaną zwrócone w odpowiedzi GET oraz w powiadomieniu webhooka.
settings
object
Ustawienia związane z tą zbiorczą weryfikacją.

Response

201 — Zbiorcza weryfikacja rozpoczęta

message
string
Komunikat potwierdzający
id
string
Unikalny identyfikator tej partii. Użyj go, aby pobrać wyniki za pomocą punktu końcowego GET.
credits_used
number
Łączna liczba zużytych kredytów. Zobacz Kredyty i rozliczenia, aby poznać koszty poszczególnych punktów końcowych.
estimated_duration
number
Szacowany czas przetwarzania w minutach (bez gwarancji)
credits
object
Zestawienie kredytów

Odpowiedzi z błędami

CodeMessage
400Missing payload
400At least 1 verification must be present in the payload
400Too many verifications. Limit is currently at 5000 per batch.
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
W przypadku niewystarczającej liczby kredytów punkt końcowy zbiorczy zwraca 402 z treścią { "message": "..." }. Zobacz Obsługa błędów, aby zapoznać się z pełną listą kodów statusu i formatów odpowiedzi.
curl --request POST \
  --url https://api.enrow.io/email/verify/bulk \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "verifications": [
      "pam.beesly@dundermifflin.com",
      "angela.martin@dundermifflin.com",
      "stanley.hudson@dundermifflin.com"
    ],
    "settings": {
      "webhook": "https://your-app.com/webhooks/enrow/verify"
    }
  }'
{
  "message": "Bulk verification operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 0.75,
  "estimated_duration": 1
}

Następne kroki

Pobierz wyniki

Pobierz wyniki weryfikacji za pomocą id partii.

Zweryfikuj pojedynczy e-mail

Sprawdź, czy jeden adres e-mail jest prawidłowy i możliwy do dostarczenia.

Kredyty i rozliczenia

Zobacz, jak zużywane są kredyty dla każdego punktu końcowego.

Webhooki

Otrzymuj automatyczne powiadomienia po zakończeniu przetwarzania partii.