• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

API и интеграция

Курсорная пагинация

Курсорная пагинация разбивает список на страницы с помощью непрозрачного токена последнего полученного элемента, поэтому новые сообщения не сдвигают и не дублируют результаты, как при нумерации страниц.

Пагинация со смещением запрашивает «элементы с 201-го по 300-й». Она проста, но ломается на списках, которые меняются, пока вы их читаете: сообщение, созданное между двумя запросами, сдвигает все последующие элементы на одну позицию, и на границе страниц один элемент повторяется или другой пропускается. Большие смещения к тому же работают медленно, потому что базе данных приходится отсчитывать всё, что она пропускает.

Курсор указывает позицию, а не смещение. Сервер кодирует место, где закончилась последняя страница, — обычно ключ сортировки и идентификатор её последнего элемента — в непрозрачный токен; клиент передаёт этот токен обратно, чтобы получить следующую страницу, и сервер продолжает ровно с этого места. Новые элементы, появляющиеся в начале списка, упорядоченного от новых к старым, не мешают уже начатому обходу; их подхватит следующий обход. Ответ обычно содержит элементы, курсор для следующей страницы и флаг, показывающий, есть ли ещё страницы.

Компромиссы здесь сознательные: нельзя сразу перейти на 40-ю страницу, общего количества часто нет, а страницы загружаются одна за другой, а не параллельно.

Пример

Условное задание сверки читает сообщения за последний час, от новых к старым, по сто за раз, а трафик тем временем продолжает поступать. При смещениях каждое новое сообщение сдвигало бы страницы прямо во время чтения, и некоторые сообщения учитывались бы дважды. С курсором каждый запрос продолжает чтение после последнего полученного сообщения, и каждое сообщение учитывается один раз.

Типичные ошибки

  • Разбирать или формировать курсоры самостоятельно: они намеренно непрозрачны, и их формат может измениться.
  • Менять фильтры посреди обхода, продолжая использовать старый курсор.
  • Останавливаться на первой неполной или пустой странице, не проверив флаг.
  • Постранично перебирать списки, чтобы отслеживать изменения статусов, которые и так передал бы вебхук.

В SMSMeteor: GET /v1/messages выводит список сообщений с фильтрацией и курсорной пагинацией: limit — от 1 до 200, по умолчанию 50, а cursor — непрозрачный курсор из поля next_cursor предыдущей страницы. Каждый ответ содержит data, next_cursor и has_more; продолжайте запрашивать страницы, пока has_more равно true. Записи о сообщениях хранятся 90 дней, а сводки по кампаниям — бессрочно. Для разовой выгрузки проще может оказаться экспорт отчёта в CSV или JSON, а вебхуки передают события sent, delivered и failed по мере их возникновения. Подробности — в справочнике API.

Подробнее

Посмотрите, как это работает на практике.Для регистрации достаточно адреса электронной почты. Таблица тарифов открыта, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку