> ## 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.

# CMS API Aperçu

> Lisez et écrivez des entrées CMS à partir de sites Web, d'applications et d'intégrations fiables.

Le CMS API expose les bases de données personnalisées que vous créez dans Plato CMS.

Utilisez-le pour les sites Web, les catalogues, les pages de destination, les portails partenaires et les outils internes nécessitant un contenu structuré provenant d'un espace de travail Plato.

<CardGroup cols={3}>
  <Card title="Liste des entrées" icon="rows-3" href="/fr/api-reference/cms/list-entries">
    Récupérez les entrées avec des champs, des filtres, une pagination et des en-têtes de réponse prévisibles.
  </Card>

  <Card title="Obtenez une entrée" icon="database" href="/fr/api-reference/cms/get-entry">
    Lisez une seule entrée CMS par identifiant à partir d’une intégration fiable.
  </Card>

  <Card title="Créer une entrée" icon="plus" href="/fr/api-reference/cms/create-entry">
    Ajoutez du nouveau contenu CMS à partir d'un backend, d'un site Web ou d'un outil interne.
  </Card>

  <Card title="Mettre à jour l'entrée" icon="settings" href="/fr/api-reference/cms/update-entry">
    Corrigez ou remplacez le contenu CMS existant en toute sécurité.
  </Card>

  <Card title="Supprimer l'entrée" icon="archive" href="/fr/api-reference/cms/delete-entry">
    Supprimez les enregistrements CMS lorsque l'intégration est propriétaire du cycle de vie.
  </Card>

  <Card title="Champs et relations" icon="link" href="/fr/api-reference/cms/fields-and-values">
    Comprenez les valeurs, les champs système, les identifiants de relation et le contenu lié.
  </Card>
</CardGroup>

## Points de terminaison

```text theme={null}
GET    /api/public/cms/[modelId]/list
POST   /api/public/cms/[modelId]/list
GET    /api/public/cms/[modelId]/[id]
PATCH  /api/public/cms/[modelId]/[id]
PUT    /api/public/cms/[modelId]/[id]
DELETE /api/public/cms/[modelId]/[id]
```

`modelId` peut être l'identifiant de la base de données CMS ou l'identifiant de la base de données.

Utilisez des identifiants de base de données lisibles tels que `products`, `locations` ou `team_members` lorsque cela est possible. Ils facilitent la maintenance des URL API.

## Authentification

Les points de terminaison CMS acceptent :

```http theme={null}
Authorization: Bearer plato_your_api_key
```

ou:

```http theme={null}
x-api-key: plato_your_api_key
```

Les intégrations plus anciennes peuvent utiliser :

```text theme={null}
?apiKey=plato_your_api_key
```

Le rôle clé API doit inclure l'accès CMS.

## Champs système

Chaque entrée peut inclure :

| Champ       | Signification                                                |
| ----------- | ------------------------------------------------------------ |
| `id`        | Identifiant d'entrée.                                        |
| `createdAt` | Date de création de l'entrée.                                |
| `updatedAt` | Date de la dernière mise à jour, lorsqu'elle est disponible. |

Ces champs sont sélectionnés par défaut lorsqu'aucune requête `fields` n'est envoyée.

## En-têtes de réponse

Les réponses de liste et d’entrée incluent les en-têtes de métadonnées CMS.

| En-tête                  | Signification                                                            |
| ------------------------ | ------------------------------------------------------------------------ |
| `x-cms-model-id`         | L'identifiant de la base de données interne qui correspond à la demande. |
| `x-cms-model-identifier` | L'identifiant de base de données lisible, une fois configuré.            |
| `x-cms-total`            | Nombre total d'entrées pour les demandes de liste.                       |
| `x-cms-limit`            | Limite utilisée par la demande de liste.                                 |
| `x-cms-offset`           | Décalage utilisé par la demande de liste.                                |
| `x-cms-has-more`         | `1` lorsque plusieurs lignes sont disponibles.                           |

## Débit typique

1. Créez ou ouvrez la base de données CMS dans Plato.
2. Confirmez l'identifiant de la base de données et les clés de champ.
3. Créez une clé API avec un accès CMS.
4. Répertoriez les entrées avec les champs dont votre application a besoin.
5. Utilisez la création, la mise à jour et la suppression uniquement à partir du code du serveur approuvé.

Pour la configuration du schéma, voir [Outils de développement CMS](/fr/cms/developer/tools).