Skip to main content
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

​
Prérequis

L’API nécessite l’offre Pro. Consultez Offres et tarifs pour comparer les offres ou changer d’abonnement.

​
Ressources disponibles

Événements

Créez et gérez les séances de l’agenda.

Lieux

Gérez les lieux de la carte interactive.

Articles

Publiez et mettez à jour les articles du blog.

Webhooks

Configurez des notifications en temps réel.

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

​
Format des réponses

Toutes les réponses sont au format JSON. Chaque ressource comprend les champs communs suivants : 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.

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