Ordinamento Risultati
Le API di Sibill supportano l'ordinamento dei risultati per specifici campi delle risposte. Ogni risorsa definisce un insieme di campi su cui è possibile effettuare l'ordinamento.
Come si fa
I campi in base ai quali si desidera effettuare l'ordinamento devono essere passati in query string
nella seguente forma:
sort=field_name
oppure sort=-field_name
Se il nome del campo è preceduto da un -
(segno meno), l'ordinamento sarà in ordine discendente
.
In caso contrario, l'ordinamento sarà in ordine ascendente
(predefinito).
Esempio di utilizzo dell'API con ordinamento ascendente:
GET /api/v1/companies/:company_id/documents?sort="creation_date"
La chiamata precedente recupererà tutti i documenti e li ordinerà per data di creazione ascendente.
Esempio di utilizzo dell'API con ordinamento discendente:
GET /api/v1/companies/:company_id/documents?sort="-creation_date"
In questo caso, i documenti saranno ordinati in modo che quelli più recenti appaiano in cima alla lista.
Esempio di utilizzo dell'API con ordinamento su più campi:
GET /api/v1/companies/:company_id/documents?sort="-creation_date,number"
In questo caso, i documenti saranno ordinati per creation_date
e poi per number
.