Référence de l'API
Guide d'intégration pour Zapier et d'autres plateformes — authentification, points de terminaison et charges utiles des webhooks.
L'API Dashform 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.
Authentification
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_TOKENPoints de terminaison OAuth
GET /api/oauth/authorize— page d'autorisationPOST /api/oauth/token— échange du code contre un jeton
Obtenir l'utilisateur actuel
GET /api/v1/meRenvoie des informations sur l'utilisateur authentifié.
{
"id": "user_123",
"name": "John Doe",
"email": "john@example.com"
}Lister les formulaires
GET /api/v1/formsRenvoie la liste des formulaires détenus par l'utilisateur authentifié.
[
{
"id": "form_123",
"name": "Contact Form",
"description": "Main contact form"
}
]Webhooks (REST hooks)
S'abonner
POST /api/webhooks/zapier/subscribeS'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ésabonner
DELETE /api/v1/hooks/unsubscribe/:idSe désabonner des notifications de webhook.
{
"success": true,
"message": "Hook deleted successfully"
}Lister les hooks
GET /api/v1/hooksLister tous les abonnements aux webhooks actifs.
[
{
"id": "hook_123",
"form_id": "form_123",
"target_url": "https://hooks.zapier.com/...",
"status": "active"
}
]Déclencheurs
GET /api/v1/triggers/new-submissionRé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 webhook
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"
}