PayZu CellApoio
Paginação
Percorra uma lista até o último item com o cursor que cada página devolve.
| Campo | Onde vai | Regra |
|---|---|---|
limit | Query | Itens por página, de 1 a 100. Sem ele, a página traz 20 itens. |
cursor | Query | O nextCursor da página anterior. Sem ele, ou com ele vazio, a lista começa do primeiro item. |
data | Resposta | Os itens da página. |
nextCursor | Resposta | O cursor da próxima página. Vem null na última. |
Como percorrer
- Chame a rota sem
cursor. - Enquanto
nextCursornão viernull, repita a chamada comcursorigual a esse valor. - Mantenha os mesmos filtros e a mesma ordenação em todas as páginas.
O cursor é um texto opaco: envie o valor como veio, sem montar nem alterar.
Cursor inválido e limite fora da faixa são recusados.
A resposta é 400. Quando o erro aponta o parâmetro, ele vem em details.
| Código | HTTP | Mensagem |
|---|---|---|
PZC001 | 400 | Corpo ou parâmetro fora do formato. |
Rotas com paginação
| Operação | Rota |
|---|---|
| Listar os chips | GET /v1/sims |
| Listar os titulares | GET /v1/customers |
| Listar as linhas | GET /v1/lines |
| Listar as cobranças | GET /v1/charges |
| Listar o extrato da carteira | GET /v1/wallet/entries |
O cursor do extrato da carteira vale 50 minutos. Vencido, a leitura recomeça sem cursor.