> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# Liste des entrées CMS

> Récupérez une liste paginée d’entrées à partir d’une base de données CMS.

Utilisez des requêtes de liste pour afficher des pages, synchroniser du contenu ou récupérer une petite page d'enregistrements.

```text theme={null}
GET /api/public/cms/[modelId]/list
```

## Exemple

```bash theme={null}
curl "https://api.plato.ae/api/public/cms/products/list?limit=20&offset=0" \
  -H "Authorization: Bearer $PLATO_API_KEY"
```

## Paramètres de requête

| Paramètre       | Taper     | Défaut                            | Remarques                                                     |
| --------------- | --------- | --------------------------------- | ------------------------------------------------------------- |
| `limit`         | nombre    | `20`                              | `1` minimum, `100` maximum.                                   |
| `offset`        | nombre    | `0`                               | Nombre d'entrées à ignorer.                                   |
| `fields`        | chaîne    | champs système et champs visibles | Sélectionnez des champs spécifiques.                          |
| `includeHidden` | booléenne | `false`                           | Incluez les champs CMS masqués lorsque la clé peut y accéder. |
| `maxDepth`      | nombre    | `3`                               | Profondeur d’expansion de la relation. `6` maximale.          |

## Sélectionnez les champs

Utilisez `fields` pour que les réponses soient petites :

```bash theme={null}
curl "https://api.plato.ae/api/public/cms/products/list?fields=id,name,price,category(id,name)" \
  -H "Authorization: Bearer $PLATO_API_KEY"
```

Les champs de relation imbriqués utilisent des parenthèses :

```text theme={null}
category(id,name)
```

## Réponse

Le corps de la réponse est un tableau.

```json theme={null}
[
  {
    "id": "entry_123",
    "name": {
      "en": "Classic Burger",
      "ar": "Classic Burger"
    },
    "price": 38,
    "category": {
      "id": "entry_category_1",
      "name": {
        "en": "Burgers"
      }
    }
  }
]
```

Les métadonnées de pagination sont renvoyées dans les en-têtes :

```text theme={null}
x-cms-total: 86
x-cms-limit: 20
x-cms-offset: 0
x-cms-has-more: 1
```

## Page suivante

Augmentez `offset` du nombre de lignes déjà chargées :

```bash theme={null}
curl "https://api.plato.ae/api/public/cms/products/list?limit=20&offset=20" \
  -H "Authorization: Bearer $PLATO_API_KEY"
```

## Remarques

* Les listes sont limitées à l'espace de travail attaché à la clé API.
* Les noms de champs inconnus renvoient `400`.
* L’expansion de la relation s’arrête à `maxDepth`.
* Pour les pages publiques, sélectionnez uniquement les champs nécessaires sur cette page.