웹훅 개요
🔔 최신화 일자: 2025-02-21
이 문서는 웹훅이 필요한 nachocode 기능을 사용할 때 참고해야 하는 웹훅 이벤트 타입 및 요청 방식, 테스트 방법 등 웹훅 정책 대해 안내합니다.
웹훅 타입
nachocode에서 제공하는 웹훅 이벤트의 종류는 다음과 같습니다.
인앱결제
| 이벤트 타입 | 설명 |
|---|---|
purchase | 구매 성공 이벤트입니다. |
refund | 환불 감지 이벤트입니다. |
기본 사항
nachocode 웹훅은 특정 이벤트 발생 시 설정된 엔드포인트로 HTTP 요청을 전송합니다. 모든 웹훅 요청은 공통적인 설정 값을 따르며, 안정적인 연동을 위해 아래 내용을 참고해주세요.
웹훅 요청 방식
nachocode 웹훅은 아래와 같은 형식을 통해 이벤트 데이터를 전달합니다.
| 항목 | 설명 |
|---|---|
| 요청 방식 | POST |
| 컨텐츠 타입 | application/json |
| 응답 상태 코드 처리 | 2xx 응답 시 웹훅 전송 성공으로 간주 |
| 요청 제한 시간 | 10초 (응답 지연 시 요청이 실패로 처리) |
| 재시도 정책 | ❌ (대시보드에서 재전송 가능) |
요청 정보
요청 본문은 웹훅 카테고리 하위에 위치한 각 기능 페이지에서 확인하실 수 있습니다.
요청 헤더
웹훅 요청은 다음과 같은 HTTP 헤더를 포함합니다. Bearer Token은 대시보드에서 설정한 웹훅 키가 존재할 경우에만 설정됩니다.
| 헤더 | 설명 |
|---|---|
Content-Type | application/json |
Authorization | Bearer {your-webhook-key} |
테스트 방법
웹훅 수신 테스트를 위해서는 다음과 같은 방법을 사용할 수 있습니다.
1. webhook.site 활용
webhook.site는 웹훅 요청을 테스트할 수 있는 무료 도구로, nachocode 웹훅의 요청 데이터를 실시간으로 확인할 수 있습니다.
사용 방법
- webhook.site에 접속합니다.
- 페이지를 열면 자동으로 고유한 웹훅 엔드포인트 URL이 생성됩니다.
- nachocode 대시보드에서 웹훅 엔드포인트를 webhook.site에서 생성된 URL로 설정합니다.
- 나쵸코드 대시보드에서 테스트할 웹훅 이벤트를 발생시킵니다. (예: 결제 테스트)
- webhook.site 페이지에서 nachocode가 전송한 요청 데이터를 확인합니다.
추가 정보
로컬 개발 환경에서 웹훅을 수신받아 테스트할 수 있는 방법을 제공할 예정입니다. 웹훅과 관련하여 궁금한 점이 있다면 support@nachocode.io로 문의해주세요.