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

# Gérer les articles du blog avec l’API REST Amply

> Créez et gérez les articles du blog via l’API REST Amply. Contrôlez le contenu, les métadonnées et la publication.

La ressource Articles permet de créer et de gérer les articles du blog et les actualités par programmation. Utilisez-la pour synchroniser les contenus d’un CMS ou automatiser leur gestion. L’API permet de contrôler l’état de publication, la programmation et les métadonnées.

## Points de terminaison

| Méthode | Chemin | Description |
| - | - | - |
| `GET` | `/articles` | Lister les articles |
| `POST` | `/articles` | Créer un article |

***

## GET /articles — Lister les articles

Renvoie une liste paginée des articles du projet.

### Paramètres de requête

<ParamField query="status" type="string">
  Filtre selon l’état de publication. Valeurs acceptées : `draft` et `published`.
</ParamField>

<ParamField query="limit" type="integer">
  Nombre maximal de résultats par page. Valeur par défaut : `50`. Maximum : `200`.
</ParamField>

<ParamField query="offset" type="integer">
  Nombre de résultats à ignorer pour la pagination. Valeur par défaut : `0`.
</ParamField>

### Exemple de requête

```bash theme={null}
curl https://api.amply-app.com/v1/articles \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Exemple de réponse

```json theme={null}
{
  "data": [
    {
      "id": "art_def456",
      "title": "Welcome to the Festival",
      "status": "published",
      "published_at": "2024-07-01T08:00:00Z",
      "excerpt": "Everything you need to know before arriving.",
      "created_at": "2024-06-28T10:00:00Z"
    }
  ],
  "total": 8
}
```

***

## POST /articles — Créer un article

Crée un article dans le projet. Définissez `status` sur `published` pour le rendre visible immédiatement ou sur `draft` pour conserver un brouillon.

### Paramètres du corps

<ParamField body="title" type="string" required>
  Titre de l’article.
</ParamField>

<ParamField body="content" type="string">
  Contenu complet de l’article au format HTML ou Markdown.
</ParamField>

<ParamField body="status" type="string">
  État de publication. Valeurs acceptées : `draft` (par défaut) et `published`.
</ParamField>

<ParamField body="published_at" type="string">
  Date et heure au format ISO 8601. Avec `status: published`, cette valeur définit la date de publication de l’article. Elle permet d’antidater un article ou de programmer sa publication.
</ParamField>

<ParamField body="cover_image_url" type="string">
  URL complète de l’image de couverture, par exemple `https://cdn.example.com/image.jpg`.
</ParamField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.amply-app.com/v1/articles \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Welcome to the Festival",
    "content": "<p>Everything you need to know before arriving.</p>",
    "status": "published",
    "published_at": "2024-07-01T08:00:00Z",
    "cover_image_url": "https://cdn.example.com/festival-cover.jpg"
  }'
```


## Related topics

- [Gérer vos contenus avec l’API REST Amply](/api-reference/introduction.md)
- [Gérer les événements et les séances avec l’API REST](/api-reference/events.md)
- [Gérer les lieux et les points d’intérêt avec l’API REST](/api-reference/places.md)
- [Partager des informations avec le module Newsletter](/modules/blog.md)
- [Choisir parmi les modules Amply](/modules/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.