Paginação

Endpoints que retornam listas (reconhecimentos, câmeras, alertas, webhooks) usam paginação baseada em cursor.

Como funciona

Cada resposta paginada inclui um campo nextKey. Se nextKey for null, não há mais resultados. Se tiver um valor, passe-o como lastKey na próxima requisição.

Exemplo

Primeira requisição:

curl "https://api.placaflow.com.br/api/recognitions?limit=10" \
  -H "Authorization: Bearer pk_a1b2c3d4..."

Resposta:

{
  "recognitions": [ ... 10 itens ... ],
  "nextKey": "eyJpZCI6IjU1MGU4NDAwLi4uIiwidGltZXN0YW1wIjoiMjAyNi0wMy0yMlQxNDozMDowMC4wMDBaIn0="
}

Segunda requisição (próxima página):

curl "https://api.placaflow.com.br/api/recognitions?limit=10&lastKey=eyJpZCI6IjU1MGU4NDAwLi4u" \
  -H "Authorization: Bearer pk_a1b2c3d4..."

Última página:

{
  "recognitions": [ ... 3 itens ... ],
  "nextKey": null
}

Parâmetros

Observações

• O cursor é um token opaco (base64). Não tente decodificá-lo ou construí-lo manualmente.
• Os resultados são ordenados por data, do mais recente para o mais antigo.
• Filtros (plate, cameraId, from, to) podem ser combinados com paginação.
• O limit define o máximo de itens por página, mas a resposta pode conter menos se houver filtros aplicados.