API REST v1

L'API REST v1 permet d'integrer Digisimma Pages a vos outils externes : CRM, automatisations Zapier, Make, ou n8n.

Disponible sur les plans Business et Agency.

Authentification

Toutes les requetes API utilisent un Bearer token au format dgp_ suivi de 48 caracteres hexadecimaux.

Authorization: Bearer dgp_a1b2c3d4e5f6...

Generez vos cles depuis Mon Espace > Integraciones > Cles API. Chaque cle a un ou plusieurs scopes et peut etre revoquee a tout moment.

Scopes disponibles

read : lecture des pages, leads, analytics
write : creation et modification des pages et blocs
admin : acces complet (write + gestion des cles, webhooks, agences)

Endpoints

Authentification :

GET /api/v1/auth/test

Verifie la validite d'une cle et retourne les informations de l'agence associee.

Pages :

GET    /api/v1/pages              # Lister toutes les pages
GET    /api/v1/pages/:id         # Detail d'une page (UUID ou slug)
POST   /api/v1/pages              # Creer une nouvelle page
PUT    /api/v1/pages/:id         # Mettre a jour une page
POST   /api/v1/pages/:id/publish # Publier une page

Leads :

GET    /api/v1/leads             # Lister les leads (filtrable par page)
POST   /api/v1/leads             # Ajouter un lead manuellement

Analytics :

GET    /api/v1/analytics         # Resume analytics par page (range configurable)

Webhooks :

GET    /api/v1/webhooks          # Lister les webhooks
POST   /api/v1/webhooks          # Creer un webhook
POST   /api/v1/webhooks/:id/test # Tester un webhook

Format de reponse

Toutes les reponses suivent le meme format :

{
  "success": true,
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-05-23T10:00:00Z"
  }
}

Rate limiting

La limite est de 100 requetes par minute par cle API. Le depassement retourne un 429 Too Many Requests avec l'en-tete Retry-After.

Documentation interactive

La documentation OpenAPI 3.1 complete est disponible sur /api/docs (Stoplight Elements).

API REST v1 : Bearer dgp_, 10 endpoints, scopes