L’API REST v1, pas à pas

L’API est la même porte que le serveur MCP, sans assistant au milieu : votre CRM, une automatisation Zapier, Make ou n8n, ou un script, parlent directement à Agora Page. Une page peut être créée, modifiée, publiée ; les demandes reçues et les statistiques se lisent ; un webhook vous prévient à chaque événement.

Avant de commencer

L’offre Studio ouvre les clés en lecture (1 000 appels par jour). L’offre Agency ouvre aussi l’écriture (créer, modifier, publier) et les webhooks avancés. Le serveur applique ces limites : une clé Studio qui tente d’écrire reçoit un refus, pas une erreur mystérieuse.
Une clé se crée dans Mon espace > Intégrations. Elle commence par dgp_, n’est affichée qu’une fois, et se révoque à tout moment.

1. Une première requête

Remplacez la clé par la vôtre et exécutez ceci dans un terminal, ou collez l’adresse dans l’outil « Requête HTTP » de Zapier, Make ou n8n avec l’en-tête Authorization :

curl -H "Authorization: Bearer dgp_votre_cle" https://www.agorapage.com/api/v1/me

Si la réponse contient "success": true, la clé est reconnue. Toutes les réponses ont cette forme :

{
  "success": true,
  "data": { },
  "meta": { "request_id": "…", "timestamp": "2026-09-08T10:00:00Z" }
}

En cas de refus, success vaut false et error dit pourquoi, en un mot (unauthorized, plan_required, page_quota_exceeded, slug_exists).

2. Créer une page

Une page se crée en un appel, avec son adresse (slug), son nom, et ce qu’elle contient. Les blocs sont ceux de l’éditeur, avec les mêmes réglages :

curl -X POST https://www.agorapage.com/api/v1/pages \
  -H "Authorization: Bearer dgp_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "le-comptoir-d-or",
    "client_name": "Le Comptoir d’Or",
    "status": "published",
    "identity": { "name": "Le Comptoir d’Or", "tagline": "Torréfaction maison" },
    "blocks": [
      { "id": "h", "type": "header", "columnSpan": "full" },
      { "id": "l", "type": "link", "label": "Réserver", "url": "https://exemple.fr/reserver", "columnSpan": "full" }
    ]
  }'

La réponse 201 rend la page créée, avec son identifiant. Elle répond aussitôt à https://www.agorapage.com/le-comptoir-d-or.

La preuve : la page vitrine d’Agora Page, agorapage.com/agora-page, a été créée exactement ainsi le 8 septembre 2026, par une clé du compte de démonstration, journal d’appel à l’appui (inventory/captures-v05/journal-api.json dans le dépôt).

3. Ce que l’API permet

Ce que vous voulez	L’appel
Vérifier une clé	`GET /api/v1/me`
Lister vos pages	`GET /api/v1/pages`
Lire une page (identifiant ou adresse)	`GET /api/v1/pages/:id`
Créer une page	`POST /api/v1/pages`
Modifier une page	`PATCH /api/v1/pages/:id`
Publier une page	`POST /api/v1/pages/:id/publish`
Supprimer une page	`DELETE /api/v1/pages/:id`
Lire les demandes reçues	`GET /api/v1/leads`
Ajouter une demande à la main	`POST /api/v1/leads`
Lire les statistiques d’une page	`GET /api/v1/analytics`
Gérer les webhooks	`GET`, `POST /api/v1/webhooks`, `POST /api/v1/webhooks/:id/test`
Lister les modèles de la galerie	`GET /api/v1/templates` (sans clé)

La référence complète (chaque paramètre, chaque schéma de réponse, le contrat OpenAPI 3.1) se lit depuis votre espace, connecté : ouvrir la référence. Elle n’est pas publique, et c’est voulu.

4. Les limites, dites avant

Par minute : chaque clé porte une limite de requêtes par minute, fixée à sa création (100 par défaut). Au-delà, 429 avec l’en-tête Retry-After.
Par jour : 1 000 appels pour Studio, sans plafond pour Agency.
Par offre : l’écriture demande Agency. Le nombre de pages est celui de votre offre : au-delà, page_quota_exceeded.
Par espace : une clé ne voit que les pages de l’espace qui l’a créée. Jamais celles d’un autre compte.

L’API REST v1, pas à pas : une clé, une adresse, une première requête