Amazon API массовой проверки номеров: быстрая проверка

Проверьте, привязан ли указанный глобальный номер к аккаунту Amazon

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

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

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

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.164
task_type	string, Тип задачи, установите “amazon”

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

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

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

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

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

Поле	Описание	Пример
Number	Номер телефона в формате E.164	+41798284651
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, внутренняя ошибка сервера, повторите попытку позже