API проверки RCS: быстрая проверка номеров телефонов

Проверьте детали RCS введенных глобальных номеров телефонов, поддерживают ли они обмен сообщениями RCS

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

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

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

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,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "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...",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

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

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

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

Параметр	Описание
file	file, загрузите файл; каждая строка должна содержать один номер в формате E.164
task_type	string, тип задачи, установите rcs

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

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

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

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

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

Поле	Описание	Пример
Number	Номер телефона в формате E.164	+12025551234
rcs	Имеет ли номер включенный RCS	yes, no

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

Поле	Описание
created_at	Временная метка создания задачи
updated_at	Временная метка последнего обновления задачи
task_id	Уникальный идентификатор задачи
user_id	ID пользователя
status	Статус задачи: pending: в очереди processing: обработка exported: результаты доступны для скачивания failed: задача завершилась с ошибкой, списанная сумма автоматически возвращается
total	Всего обработано номеров телефонов
success	Номера успешно идентифицированы
failure	Номера с ошибкой обработки
result_url	(Опционально) URL для скачивания результатов при статусе exported
actual_amount	(Необязательно) Фактически списанная сумма, возвращается после завершения расчёта по задаче
estimated_amount	(Ответ при создании) Ориентировочная стоимость задачи; окончательное списание происходит после её завершения

Коды статуса

Статус	Описание
200	free, запрос успешно выполнен (например, запрос статуса)
202	charge, задача успешно создана; списывается ориентировочная сумма
400	free, неверный запрос: недопустимые параметры или формат файла, неподдерживаемый тип задачи или количество корректных записей меньше минимального
401	free, отсутствует или недействителен API-ключ
402	free, недостаточно средств на балансе
404	free, задача не найдена
413	free, загруженный файл слишком большой
500	free, внутренняя ошибка сервера, повторите попытку позже