Paginação

​

Os parâmetros

​

A resposta

{
  "data": [],
  "has_more": true,
  "next_cursor": "WyIyMDI2LTA5LTI1VDEzOjAwOjAwLjAwMDAwMFoiLDEyXQ"
}

• data traz os itens da página.
• has_more diz se a lista tem mais itens depois desta página.
• next_cursor abre a próxima página. Na última página, o valor é null.

​

Como percorrer a lista inteira

1. Chame a lista sem cursor.
2. Leia os itens de data.
3. Se has_more for true, chame a lista de novo com cursor igual a next_cursor. Repita os mesmos filtros.
4. Pare quando has_more for false.

​

As regras do cursor

• Trate o cursor como um texto opaco. Nunca monte nem altere um cursor.
• Um cursor alterado recebe 400 com o código invalid_parameter.
• Um limit fora de 1 a 100 recebe 400 com o código invalid_parameter.
• Um item novo não muda as páginas seguintes. O seu sistema recebe cada item uma vez só, e nenhum item antigo fica de fora.
• O item novo aparece na primeira página, na próxima vez que o seu sistema percorrer a lista.