Paginación

Los endpoints de lista del API devuelven los datos paginados. En la plataforma coexisten históricamente dos esquemas de paginación; el esquema concreto se indica en cada endpoint dentro de la referencia interactiva.

Esquema 1 — desplazamiento y X-Total-Count

Paginación clásica por desplazamiento. La solicitud acepta los parámetros de consulta limit (tamaño de página) y offset (cuántos registros omitir):

curl -H "Authorization: Bearer mbp_TU_TOKEN" "https://tu-dominio/api/bots/BOT_ID/subscribers?limit=50&offset=100"

El número total de registros se devuelve en el encabezado de respuesta X-Total-Count. Con él se calcula el número de páginas: recorre aumentando offset en limit mientras offset sea menor que el valor de X-Total-Count. El cuerpo de la respuesta es un array con los elementos de la página actual.

Esquema 2 — cursor before y has_more

Paginación por cursor para feeds ordenados por tiempo (por ejemplo, mensajes de diálogo). La solicitud acepta limit y el cursor opcional before — el identificador o marca del último elemento ya recibido:

curl -H "Authorization: Bearer mbp_TU_TOKEN" "https://tu-dominio/api/bots/BOT_ID/users/USER_ID/dialog?limit=50&before=CURSOR"

La respuesta contiene una página de elementos y el indicador has_more. Mientras has_more sea true, repite la solicitud pasando en before el cursor del último elemento recibido. Cuando has_more sea false — es la última página.

Qué esquema elegir

No eliges el esquema — lo determina el endpoint. Las listas de referencia suelen usar desplazamiento y X-Total-Count; los feeds por tiempo — cursor before y has_more. Consulta siempre la página del endpoint en la referencia.

Qué sigue