> ## 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 vos contenus avec l’API REST Amply

> L’API REST Amply permet de créer, lire, modifier et supprimer des événements, lieux, articles et webhooks. L’offre Pro est nécessaire.

L’API REST Amply permet de gérer les contenus de votre projet par programmation, notamment pour les synchroniser avec une billetterie, un CRM ou vos outils internes. Les points de terminaison suivent les conventions REST et renvoient des réponses JSON.

## URL de base

```text theme={null}
https://api.amply-app.com/v1
```

## Prérequis

<Note>
  L’API nécessite l’**offre Pro**. Consultez [Offres et tarifs](/plans-and-pricing) pour comparer les offres ou changer d’abonnement.
</Note>

## Ressources disponibles

<CardGroup cols={2}>
  <Card title="Événements" icon="calendar" href="/api-reference/events">
    Créez et gérez les séances de l’agenda.
  </Card>

  <Card title="Lieux" icon="map-pin" href="/api-reference/places">
    Gérez les lieux de la carte interactive.
  </Card>

  <Card title="Articles" icon="newspaper" href="/api-reference/articles">
    Publiez et mettez à jour les articles du blog.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks">
    Configurez des notifications en temps réel.
  </Card>
</CardGroup>

## Format des requêtes

Les corps des requêtes doivent être au format JSON. Ajoutez l’en-tête `Content-Type: application/json` à toute requête contenant un corps, notamment les requêtes `POST` et `PUT`.

```bash theme={null}
curl -X POST https://api.amply-app.com/v1/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "title": "My Event", "start_time": "2024-07-20T09:00:00Z", "end_time": "2024-07-20T10:00:00Z" }'
```

## Format des réponses

Toutes les réponses sont au format JSON. Chaque ressource comprend les champs communs suivants :

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant unique de la ressource |
| `created_at` | string | Horodatage de création au format ISO 8601 |
| `updated_at` | string | Horodatage de dernière modification au format ISO 8601 |

Les listes renvoient un tableau `data` et les informations de pagination `total`, `limit` et `offset`.

## Codes d’erreur

Lorsqu’une requête échoue, l’API renvoie un code HTTP et un corps JSON décrivant l’erreur.

| Code HTTP | Signification |
| - | - |
| `400 Bad Request` | Paramètres manquants ou invalides |
| `401 Unauthorized` | Clé API absente ou invalide |
| `403 Forbidden` | Action non autorisée avec votre offre |
| `404 Not Found` | Ressource inexistante |
| `429 Too Many Requests` | Limite de requêtes dépassée |
| `500 Internal Server Error` | Erreur côté serveur |

## Limitation des requêtes

L’API limite le nombre de requêtes pour préserver la stabilité du service. Consultez les en-têtes des réponses pour connaître votre utilisation et le moment où la limite est réinitialisée.

Si vous dépassez cette limite, l’API renvoie `429 Too Many Requests`. Attendez la réinitialisation avant de réessayer.


## Related topics

- [Gérer les articles du blog avec l’API REST Amply](/api-reference/articles.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)
- [Comprendre l’organisation d’un projet Amply](/introduction.md)
- [Authentifier vos requêtes à l’API Amply](/api-reference/authentication.md)


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