Amazon API проверки e-mail: быстрая валидация e-mail

Проверьте, зарегистрированы ли указанные e-mail адреса в Amazon

Пример загрузки файла:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./email.txt"' \
--form 'task_type="amazon_email"'

Пример проверки статуса задачи:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Ответ при успешной загрузке файла:

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Ответ для статуса обработки:

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Ответ при завершении задачи (включает URL скачивания результата):

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

URL запроса загрузки файла

POST https://api.checknumber.ai/v1/tasks

Параметры запроса загрузки файла

Параметр	Описание
file	file, Загрузите файл; каждая строка должна содержать e-mail адрес
task_type	string, Тип задачи, установите “amazon_email”

URL запроса проверки статуса

POST https://api.checknumber.ai/v1/gettasks

Параметры запроса проверки статуса

Параметр	Описание
task_id	string, ID задачи, возвращаемый при создании

Поля результата

Поле	Описание	Пример
Email	Адрес электронной почты	user@example.com
amazon	Зарегистрирован ли адрес электронной почты в Amazon	yes, no

Формат ответа

Поле	Описание
created_at	Временная метка создания задачи
updated_at	Временная метка последнего обновления статуса задачи
task_id	Уникальный идентификатор задачи
user_id	Идентификатор пользователя
status	Статус задачи: pending: в очереди processing: обрабатывается exported: результаты доступны для скачивания
total	Всего обработано адресов электронной почты
success	Адреса электронной почты успешно проверены
failure	Адреса электронной почты, которые не удалось обработать
result_url	(Необязательно) URL для скачивания результатов при статусе exported

Коды статуса

Статус	Описание
200	charge, запрос успешно выполнен, задача создана или получен ее статус
400	free, неправильный запрос, недопустимые параметры или формат файла
500	free, внутренняя ошибка сервера, повторите попытку позже