Pagination

Les endpoints qui retournent des listes utilisent la pagination pour améliorer les performances.

Paramètres

Paramètre	Type	Défaut	Description
page	integer	0	Numéro de page (commence à 0)
size	integer	20	Nombre d'éléments par page (max 100)
sort	string	-	Tri (format: field,direction)

Exemples

Pagination simple

GET /v1/appointments?page=0&size=20

Avec tri

# Tri par date de création décroissante
GET /v1/appointments?page=0&size=20&sort=createdAt,desc

# Tri par nom croissant
GET /v1/departments?sort=name,asc

Format de réponse

{
  "content": [
    { "id": 1, "..." },
    { "id": 2, "..." }
  ],
  "pageable": {
    "pageNumber": 0,
    "pageSize": 20,
    "offset": 0
  },
  "totalElements": 150,
  "totalPages": 8,
  "last": false,
  "first": true,
  "numberOfElements": 20
}

Champs utiles

• totalElements : Nombre total d'éléments
• totalPages : Nombre total de pages
• last : Dernière page ?
• first : Première page ?
• numberOfElements : Nombre d'éléments dans cette page

Bonnes pratiques

• Commencez avec une taille de page raisonnable (20-50)
• Utilisez le tri pour un ordre déterministe
• Ne demandez pas des pages trop grandes (max 100)