Passa al contenuto principale

List company vehicle fleet with pagination

GET 
/company/vehicles/

Recupera l'intera flotta di veicoli dell'azienda autenticata con funzionalità di impaginazione, ricerca e filtraggio.

Obiettivo​

Consentire alle aziende di gestire la propria flotta visualizzando, ricercando e navigando tramite impaginazione tutti i veicoli registrati.

Casi d'Uso​

  • Visualizzare un elenco impaginato di tutti i veicoli aziendali nell'interfaccia di gestione flotta
  • Cercare veicoli specifici per targa
  • Utilizzare l'autocompletamento per una ricerca rapida dei veicoli
  • Recuperare il veicolo predefinito per le operazioni di firma digitale

Flusso di Validazione​

flowchart TD
  A[Ricevi Richiesta] --> B{Utente Autenticato?}
  B -->|No| C[401 Non Autorizzato]
  B -->|Sì| D{Utente Ha Azienda?}
  D -->|No| E[401 CIA_NON_TROVATA]
  D -->|Sì| F[Ottieni Veicoli Azienda]
  F --> G{Applica Filtri}
  G --> H[Impagina Risultati]
  H --> I{isSign = true?}
  I -->|Sì| J[Includi Veicolo Predefinito]
  I -->|No| K[Restituisci Elenco Impaginato]
  J --> K

Impaginazione​

La risposta utilizza un formato di impaginazione personalizzato con metadati che includono:

  • docs: Array di oggetti veicolo
  • totalDocs: Numero totale di veicoli corrispondenti
  • page: Numero della pagina corrente
  • limit: Risultati per pagina
  • totalPages: Numero totale di pagine
  • hasNextPage/hasPrevPage: Flag di navigazione
  • nextPage/prevPage: Numeri di pagina per la navigazione

Comportamento della Ricerca​

Sia il parametro search che autocomplete filtrano i veicoli per targa utilizzando una corrispondenza regex case-insensitive.

Request​

Responses​

Elenco flotte recuperato con successo.

Response Headers