# Получение следующего сообщения

Получение следующего сообщения или нескольких сообщений от потребителя.

<!-- -->

## Тема

`$JS.API.CONSUMER.MSG.NEXT.{stream}.{consumer}`

Где `{stream}` — имя потока, а `{consumer}` — имя потребителя.

## Запрос

Запрос к API JetStream $JS.API.CONSUMER.MSG.NEXT

expiresinteger

Время от текущего момента до истечения pull-запроса в наносекундах; 0 отключает ограничение

Длительность в наносекундах, знаковое 64-битное целое число

Минимум:`0`

Максимум:`9223372036854776000`

batchinteger

Число сообщений, которые сервер должен доставить запрашивающему

Целое число с разрядностью, зависящей от платформы кластера, до 64 бит

Минимум:`0`

Максимум:`256`

max\_bytesinteger

Максимальное число байтов для отправки запрашивающему, ограниченное max\_bytes потребителя

Целое число с разрядностью, зависящей от платформы кластера, до 64 бит

Минимум:`0`

Максимум:`9223372036854776000`

no\_waitboolean

При true и отсутствии сообщений возвращается ответ со статусом 404 в заголовке

idle\_heartbeatinteger

При ненулевом значении heartbeat бездействия отправляется с этим интервалом

Длительность в наносекундах, знаковое 64-битное целое число

Минимум:`0`

Максимум:`9223372036854776000`

groupstring

Группа потребителей для pull-запроса

min\_pendinginteger

Минимальное число ожидающих сообщений потребителя перед выполнением pull-запроса

Знаковое 64-битное целое число

Минимум:`0`

Максимум:`9223372036854776000`

min\_ack\_pendinginteger

Минимальное число сообщений в очереди ожидания подтверждений потребителя перед выполнением pull-запроса

Знаковое 64-битное целое число

Минимум:`0`

Максимум:`9223372036854776000`

idstring

Уникальный идентификатор клиента при pull-чтении из потребителя с закреплённым клиентом

priorityinteger

Приоритет pull-запроса

Минимум:`0`

Максимум:`9`
