Продукты реального времени
Эндпоинты реального времени адресуют продукты по числовому ID. Массовые эндпоинты адресуют их по slug. Они не взаимозаменяемы: и ID, переданный в массовый вызов, и slug, переданный в вызов реального времени, отклоняются.
Эта таблица генерируется из живого каталога при каждой сборке сайта, поэтому всегда совпадает с тем, что возвращает GET /v1/products.
product_ids. Realtime принимает только ID — slug из пакетной таблицы здесь не сработает. В одном запросе можно выбрать продукты только из одной серии.| Название продукта | Режим | Идентификатор | Минимум |
|---|---|---|---|
| Проверка номера Amazon | Одиночный (realtime) | #53 | 1 |
| Проверка email для Amazon | Одиночный (realtime) | #54 | 1 |
| Проверка номера Apple ID | Одиночный (realtime) | #57 | 1 |
| Проверка email для Apple ID | Одиночный (realtime) | #58 | 1 |
| Проверка номера BAND | Одиночный (realtime) | #60 | 1 |
| Проверка номера Facebook | Одиночный (realtime) | #51 | 1 |
| Проверка email для Facebook | Одиночный (realtime) | #52 | 1 |
| Проверка номера Instagram | Одиночный (realtime) | #48 | 1 |
| Проверка email для Instagram | Одиночный (realtime) | #49 | 1 |
| Проверка номера Microsoft | Одиночный (realtime) | #59 | 1 |
| Проверка номера Telegram | Одиночный (realtime) | #50 | 1 |
| Проверка номера Viber | Одиночный (realtime) | #55 | 1 |
| Проверка номера WhatsApp | Одиночный (realtime) | #47 | 1 |
| Проверка телефонного номера в X | Одиночный (realtime) | #61 | 1 |
Эта таблица автоматически обновляется из актуального каталога при каждой сборке сайта.
Как считать ID из этой таблицы
Заголовок раздела «Как считать ID из этой таблицы»Столбец # содержит значение, которое вы передаёте. Для продукта реального времени это его id в GET /v1/products.
{ "product_ids": [49] }ID выше — текущие. Продукты добавляются и выводятся из эксплуатации со временем, поэтому источником истины считайте эту страницу, а не пример, скопированный откуда-то ещё.
Две серии, без смешивания
Заголовок раздела «Две серии, без смешивания»Каждый продукт реального времени принадлежит одной серии, phone или email, и один запрос может выбирать продукты только из одной серии:
- телефонный вызов (
/v1/realtime/check/phone) принимает ID телефонных продуктов - email-вызов (
/v1/realtime/check/email) принимает ID email-продуктов
Смешивание двух серий в одном запросе отклоняется как недопустимый запрос реального времени. Правило следует из того, что проверяется: у номера телефона есть страна, у адреса электронной почты — нет, поэтому они не могут делить один проход верификации.
Выбор более одного
Заголовок раздела «Выбор более одного»В одном вызове можно передать от одного до десяти ID. Каждый выбранный продукт создаёт свою запись в results и своё списание, всё под одним request_id:
{ "product_ids": [49, 52, 54] }Больше десяти ID отклоняется с invalid_realtime_request. Чтобы выполнить больше десяти проверок для одного идентификатора, отправьте больше одного запроса — каждый со своим Idempotency-Key.
Откуда берётся цена
Заголовок раздела «Откуда берётся цена»Каждый продукт тарифицируется по своей цене за проверку, в том числе когда результат отдаётся из кэша. Эндпоинт каталога намеренно не публикует цены — GET /v1/products возвращает id, slug, name, name_translations, mode, series и min_phones, и ничего больше. Актуальные цены — на странице тарифов в вашем аккаунте.
Что именно списывается, см. в Биллинг и возвраты.