Справочник API: эндпоинт /validate

API CleanContact — это единственный эндпоинт с аутентификацией. Отправьте адрес — получите вердикт.

Запрос

Выполните GET-запрос с адресом в параметре строки и вашим ключом API в заголовке X-API-Key.

curl -H "X-API-Key: <ваш-ключ>" \
  "https://api.cleancontact.ru/validate?email=someone@example.com"

Ответ

Успешный вызов возвращает 200 с отправленным адресом и объектом результата.

{
  "value": "someone@example.com",
  "result": {
    "status": "Good",
    "detail": "Mailbox accepts mail"
  }
}

Поле status — одно из:

• Good — ящик существует и принимает почту.
• Bad — адрес не существует или отклонён.
• Unknown — однозначного ответа не получено вовремя.

Коды состояния

• 200 — проверка завершена; смотрите result.status для вердикта.
• 400 — параметр email отсутствует или некорректен.
• 401 — ключ API отсутствует, неизвестен или неактивен.
• 429 — слишком много запросов; снизьте темп и повторите.