API 레퍼런스
Zapier 및 기타 플랫폼을 위한 연동 가이드 — 인증, 엔드포인트, 웹훅 페이로드.
Dashform API를 사용하면 폼과 응답을 읽고, Zapier 및 기타 플랫폼에서 새 제출 이벤트를 구독할 수 있습니다.
인증
Dashform은 인증에 OAuth 2.0을 사용합니다. 모든 API 요청에는 유효한 액세스 토큰이 포함되어야 합니다:
Authorization: Bearer YOUR_ACCESS_TOKENOAuth 엔드포인트
GET /api/oauth/authorize— 인증 페이지POST /api/oauth/token— 코드를 토큰으로 교환
현재 사용자 가져오기
GET /api/v1/me인증된 사용자에 대한 정보를 반환합니다.
{
"id": "user_123",
"name": "John Doe",
"email": "john@example.com"
}폼 목록
GET /api/v1/forms인증된 사용자가 소유한 폼 목록을 반환합니다.
[
{
"id": "form_123",
"name": "Contact Form",
"description": "Main contact form"
}
]웹훅 (REST 훅)
구독
POST /api/webhooks/zapier/subscribe폼 응답 이벤트를 구독합니다.
요청 본문:
{
"target_url": "https://hooks.zapier.com/...",
"form_id": "form_123",
"subscription_id": "sub_123"
}form_id와 subscription_id는 선택 사항입니다 — 모든 폼의 응답을 구독하려면
form_id를 생략하세요.
응답:
{
"id": "hook_123",
"status": "subscribed"
}구독 해제
DELETE /api/v1/hooks/unsubscribe/:id웹훅 알림 구독을 해제합니다.
{
"success": true,
"message": "Hook deleted successfully"
}훅 목록
GET /api/v1/hooks활성화된 모든 웹훅 구독을 나열합니다.
[
{
"id": "hook_123",
"form_id": "form_123",
"target_url": "https://hooks.zapier.com/...",
"status": "active"
}
]트리거
GET /api/v1/triggers/new-submission트리거 테스트를 위해 최근 폼 응답을 가져옵니다. 가장 최근의 응답 3개를 반환합니다.
쿼리 매개변수:
form_id— 선택 사항: 특정 폼으로 필터링
[
{
"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"
}
]웹훅 페이로드
새 폼 응답이 수신되면 Dashform은 다음 페이로드와 함께 웹훅 URL로
POST 요청을 보냅니다:
{
"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"
}