Paginação e Filtros

Para otimizar a performance e a usabilidade, as APIs de listagem da Rede Frota utilizam paginação padrão.

Parâmetros de Requisição

Utilize os seguintes query parameters para controlar a paginação:

page:Número da página atual (1-based). Padrão = 1

page_size:Quantidade de registros por página. Padrão = 20 (Max: 100)

GET /v1/carriers/transactions?page=2&page_size=50

Resposta Paginada

A resposta conterá os dados em data e metadados em meta:

{   
    "data": [
        { "id": 1, ... },
        { "id": 2, ... }
    ],
    "previous_page": 0,
    "next_page": 0,
    "current_page": 2,
    "is_last": true,
    "total_pages": 10, 
    "total_items": 50,
    "total_items_per_page": 50,
    "paged": true
}

Filtros

Filtros específicos são documentados em cada endpoint, mas geralmente seguem o padrão campo=valor.

GET /v1/suppliers/prices?fuel_type=diesel&active=true