Intégration Zapier (API v1)

Cette page documente l'API v1, celle sur laquelle repose l'intégration Zapier de Dashform. La v1 reste prise en charge et inchangée : chaque point de terminaison et chaque charge utile de cette page se comporte exactement comme avant.

Pour tout ce qui ne concerne pas Zapier, commencez par l'API Dashform, l'API de ressources v2 pour les organisations et les formulaires.

L'API v1 vous permet de lire les formulaires et les réponses, et de vous abonner aux événements de nouvelle soumission depuis Zapier et d'autres plateformes.

AuthentificationCopy Anchor Link

Dashform utilise OAuth 2.0 pour l'authentification. Toutes les requêtes à l'API doivent inclure un jeton d'accès valide :

Authorization: Bearer YOUR_ACCESS_TOKEN

Points de terminaison OAuthCopy Anchor Link

• GET /api/oauth/authorize — page d'autorisation
• POST /api/oauth/token — échange du code contre un jeton

Obtenir l'utilisateur actuelCopy Anchor Link

GET /api/v1/me

Renvoie des informations sur l'utilisateur authentifié.

{
  "id": "user_123",
  "name": "John Doe",
  "email": "john@example.com"
}

Lister les formulairesCopy Anchor Link

GET /api/v1/forms

Renvoie la liste des formulaires détenus par l'utilisateur authentifié.

[
  {
    "id": "form_123",
    "name": "Contact Form",
    "description": "Main contact form"
  }
]

Webhooks (REST hooks)Copy Anchor Link

S'abonnerCopy Anchor Link

POST /api/webhooks/zapier/subscribe

S'abonner aux événements de réponse de formulaire.

Corps de la requête :

{
  "target_url": "https://hooks.zapier.com/...",
  "form_id": "form_123",
  "subscription_id": "sub_123"
}

form_id et subscription_id sont facultatifs — omettez form_id pour vous abonner aux réponses de tous les formulaires.

Réponse :

{
  "id": "hook_123",
  "status": "subscribed"
}

Se désabonnerCopy Anchor Link

DELETE /api/v1/hooks/unsubscribe/:id

Se désabonner des notifications de webhook.

{
  "success": true,
  "message": "Hook deleted successfully"
}

Lister les hooksCopy Anchor Link

GET /api/v1/hooks

Lister tous les abonnements aux webhooks actifs.

[
  {
    "id": "hook_123",
    "form_id": "form_123",
    "target_url": "https://hooks.zapier.com/...",
    "status": "active"
  }
]

DéclencheursCopy Anchor Link

GET /api/v1/triggers/new-submission

Récupère les réponses de formulaire récentes pour tester les déclencheurs. Renvoie les 3 réponses les plus récentes.

Paramètres de requête :

• form_id — facultatif : filtrer par un formulaire spécifique

[
  {
    "id": "reply_123",
    "form_id": "form_123",
    "form_name": "Contact Form",
    "data": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "created_at": "2025-01-01T12:00:00Z"
  }
]

Charge utile du webhookCopy Anchor Link

Lorsqu'une nouvelle réponse de formulaire est reçue, Dashform envoie une requête POST à l'URL de votre webhook avec la charge utile suivante :

{
  "id": "reply_123",
  "form_id": "form_123",
  "form_name": "Contact Form",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Hello!"
  },
  "created_at": "2025-01-01T12:00:00Z"
}