웹훅(Webhook)이란?
**웹훅(Webhook)**은 서버 간의 비동기적인 실시간 통신 방식 으로, 특정 이벤트가 발생했을 때 **자동으로 지정된 URL(엔드포인트)**로 정보를 전송하는 메커니즘 입니다. 쉽게 말해, 웹훅은 서버가 "무슨 일이 생겼을 때 상대방에게 먼저 알려주는 방법"입니다. 1. 웹훅(Webhook)이란? 웹훅은 HTTP 기반의 콜백(callback) 메커니즘 으로, **이벤트 기반(event-driven)**으로 동작합니다. 사용자가 어떤 행동을 했을 때, 그에 대한 정보를 다른 시스템에 자동으로 알려주는 것이 핵심입니다. ✅ 수동 요청이 아닌 자동 전송 ✅ 실시간 데이터 전달 ✅ 요청 주체: 이벤트가 발생한 서버 2. 웹훅의 기본 작동 방식 2.1 개념 흐름 클라이언트가 웹훅 URL을 등록 예: https://example.com/webhook 이벤트가 발생 예: 사용자가 결제를 완료함 서버가 웹훅 URL로 HTTP POST 요청 전송 JSON, XML 등의 형식으로 데이터 전달 클라이언트는 요청을 받아 필요한 작업 수행 예: DB 저장, 알림 발송 등 2.2 구조 예시 (JSON) json POST /webhook HTTP/ 1.1 Host : example.com Content-Type : application/json { "event" : "payment_success" , "user_id" : "12345" , "amount" : 10000 , "timestamp" : "2025-07-26T01:23:45Z" } 3. 웹훅과 API의 차이점 항목 API (Polling) 웹훅 (Webhook) 요청 주체 클라이언트가 서버에 요청 서버가 클라이언트에 알림 요청 방식 주기적으로 ...