Pagination

Como paginar resultados no Meaple SDK.

Cursor e `limit`

As listas paginadas da API usam paginação por cursor. Você envia:

limit — número máximo de itens retornados nessa requisição (equivalente ao “tamanho da página”).
cursor — identificador do último item da página anterior (a resposta inclui o próximo cursor quando há mais resultados).


const { events, cursor } = await sdk.events.find({
  limit: 20,
});
 
// página seguinte: use o cursor devolvido na resposta anterior
const next = await sdk.events.find({
  limit: 20,
  cursor,
});

Exemplo: próxima página


import { MeapleSDK } from '@meaple-com/core';
 
const sdk = new MeapleSDK({
  publicKey: 'pk_seu_channel_id',
});
 
const first = await sdk.events.find({ limit: 20 });
 
const next = first.cursor
  ? await sdk.events.find({ limit: 20, cursor: first.cursor })
  : undefined;

Para “Carregar mais” ou scroll infinito, guarde cursor no estado e chame find de novo quando precisar do próximo lote.

Com React Query

Passe limit e cursor conforme os tipos (FindEventsParams). Exemplo com cursor opcional no estado:


import { useEvents } from '@meaple-com/react-query';
 
function EventsList({ cursor }: { cursor?: string }) {
  const { data, isLoading } = useEvents({
    limit: 20,
    cursor,
  });
 
  if (isLoading) return <div>Carregando...</div>;
 
  return (
    <div>
      {data?.events.map(event => (
        <div key={event.id}>{event.name}</div>
      ))}
      {data?.cursor && (
        <p>Há mais resultados — use data.cursor na próxima requisição.</p>
      )}
    </div>
  );
}

Listas completas

Recursos como categorias e tags retornam a coleção inteira em uma única resposta do SDK — use o array retornado diretamente.

Próximos Passos

Core SDK - Documentação completa
Getting Started - Guia completo