Pagination, tri et filtres

Listez vos données avec pagination, tri et filtres. Chargez les relations avec populate.

Requête de base

curl "https://api.skemacms.com/public/articles" \
  -H "X-API-Key: pk_live_xxx"

Retourne les 20 premiers items par défaut.

Pagination

Utilisez page etperPage. Maximum 100 items par page.

curl "https://api.skemacms.com/public/articles?page=2&perPage=50" \
  -H "X-API-Key: pk_live_xxx"

La réponse inclut count,page,perPage ettotalPages.

Tri

Paramètre sort. Préfixez avec - pour l'ordre décroissant.

# Plus récent d'abord
?sort=-created_at

# Alphabétique (A-Z)
?sort=title

# Prix décroissant
?sort=-price

Populate (relations)

Le paramètre populate charge les relations automatiquement. Utilisez le nom du champ (local_key) qui contient la relation.

# Une relation (utilisez le nom du champ, ex: id_client)
?populate=id_client

# Plusieurs relations
?populate=id_client,id_produit

# Le champ id_client sera remplace par l'objet complet
# Avant: { "id_client": "uuid-123" }
# Apres: { "id_client": { "id": "uuid-123", "nom": "Dupont", ... } }

Important : Utilisez le nom exact du champ dans vos donnees (ex: id_client, category_id), pas le nom de la relation.

Exemple complet

curl "https://api.skemacms.com/public/commandes?page=1&perPage=10&sort=-date_commande&populate=id_client" \
  -H "X-API-Key: pk_live_xxx"

Réponse :

{
  "data": [
    {
      "id": "uuid-xxx",
      "id_client": {
        "id": "uuid-yyy",
        "nom": "Dupont",
        "email": "dupont@email.com"
      },
      "date_commande": "2026-01-17T23:59:40.219Z",
      "statut": "En attente",
      "montant_total": "3000.00"
    }
  ],
  "count": 5,
  "page": 1,
  "perPage": 10,
  "totalPages": 1
}

Créez, modifiez et supprimez des items.

CRUD complet

← Clés API CRUD complet →