Documentação técnica
Paginação e filtros
Use parâmetros de query para controlar listagem, tamanho da página e filtros técnicos nos endpoints públicos disponíveis.
Padrão suportado atualmente
O endpoint de listagem de veículos aceita o padrão page e page_size, além de filtros técnicos do catálogo público.
Request
GET {{public_catalog_base_url}}/catalog/vehicles?page=1&page_size=20&marca=ToyotaParâmetros de query
| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| marca | string | Não | Filtra por marca (ilike). | - |
| modelo | string | Não | Filtra por modelo (ilike). | - |
| categoria | string | Não | Filtra por categoria (ilike). | - |
| combustivel | string | Não | Filtra por combustível (ilike). | - |
| propulsao | string | Não | Filtra por tipo de propulsão (ilike). | - |
| transmissao | string | Não | Filtra por transmissão (ilike). | - |
| ano | number | Não | Ano exato (1900-2100); equivalente a ano_min=<ano>&ano_max=<ano>. | 2023 |
| ano_min | number | Não | Ano mínimo (1900-2100). | 2020 |
| ano_max | number | Não | Ano máximo (1900-2100). | 2026 |
| page | number | Não | Página atual (>= 1). | 1 |
| page_size | number | Não | Itens por página (1-100). | 20 |
Formato de resposta paginada
Response JSON
{
"success": true,
"data": {
"data": {
"items": [
{
"id": "001af754-592a-42ce-8227-01c958d4de3c",
"marca": "Toyota",
"modelo": "Corolla",
"versao": "Altis",
"ano": 2025,
"combustivel_tipo": "Flex"
}
]
},
"meta": {
"pagination": {
"page": 1,
"page_size": 20,
"total": 120,
"total_pages": 6
}
}
}
}