이 문서는 api를 이용해 새 웹훅을 만드는 방법에 대한 것입니다. 웹훅은 모아폼 서비스에 접속하여 urser interface를 이용해 사용자가 직접 만들 수도 있습니다. 모아폼 서비스 내에서 직접 웹훅을 만드는 방법은 Webhook > 웹훅 만들기를 참고하세요.
api로 특정 설문(form_id)에 새 웹훅을 만들 수 있습니다.
[POST] https://api.moaform.com/v1/forms/{form_id}/webhooks
요청
Path Parameters
| Key | Description |
|---|---|
| form_id | 필수. 설문의 고유 ID |
Body
| PARAMETER | TYPE | DESCRIPTION |
|---|---|---|
| endpoint | string | 필수. 웹훅 수신 URL |
| enabled | boolean | 웹훅 활성화 여부, 기본값 false |
| secret | string | 비밀 코드, 기본값 null |
| verify_ssl | boolean | Endpoint SSL 인증서 검증 여부, 기본값 true |
| retention_days | integer | 재전송 제한 일수 (1,3,5,7,10,15,30 중 하나), 기본값 7 |
각 설정들에 대한 세부 설명은 Webhook > 웹훅 만들기를 참고하세요.
응답
| Key | Type | Description |
|---|---|---|
| id | string | 웹훅의 고유 ID |
| endpoint | string | 웹훅의 Endpoint |
| enabled | boolean | 웹훅 활성 여부 |
| secret | string | 비밀 코드 |
| verify_ssl | boolean | Endpoint SSL 인증서 검증 여부 |
| retention_days | integer | 재전송 제한 일수 |
| created_at | string | 웹훅 생성 일시 |
| updated_at | string | 웹훅 수정 일시 |