에서 웹훅에 대해 설명하기 전에 콜백 개념을 설명해야 합니다. 실생활에서 현재 통화 중인 친구에게 전화를 걸면 친구가 다시 전화하겠다고 약속하는 콜백을 경험할 수 있습니다. API의 경우 콜백 은 메시지(호출)를 수신하는 데 사용되는 애플리케이션의 인터페이스(예: HTTP 엔드포인트)입니다.
콜백 API의 통신 흐름은 다음과 같이 진행됩니다. 알림을 받고자 하는 대상 서비스는 이벤트를 생성하는 소스 서비스 내에 콜백을 등록하고, 소스 서비스에서 보낸 모든 메시지는 응답을 통해 대상 서비스에서 확인받아야 하는 것이 콜백 API의 원칙입니다.
웹후크는 소스 서비스의 이벤트에 의해 트리거되고 대상 서비스에 정의된 콜백 URL로 전송되는 HTTP 요청입니다. 웹후크 페이로드 데이터에는 이벤트에 대한 정보가 포함됩니다. 그러면 대상 서비스는 데이터를 처리하고 이벤트 발생에 대한 응답을 합니다.
이 장에서는 웹후크의 기원, 분류 및 장단점에 대해 소개합니다. 이 장을 완료하면 웹후크가 사용 사례에 적합한지 여부를 결정하는 데 도움이 됩니다. 개념적 지식 외에도 웹후크 API를 구현, 보안 및 문서화하는 실용적인 기술을 습득할 수 있습니다.
웹훅이란 무엇인가요?
웹후크( )는 HTTP 푸시 API, HTTP 콜백, 리버스 API 등 다양한 이름으로 불립니다. 웹후크의 목적은 대상 서비스가 명시적으로 메시지를 요청하지 않고 소스에서 대상 서비스로 메시지를 보내는 것입니다. 대상 서비스는 메시지가 유입되는 열린 문 역할을 하는 엔드포인트(콜백)를 노출합니다. 가장 일반적인 구현에서 웹후크는 HTTP POST 방식을 사용하지만 덜 일반적인 HTTP GET 방식을 사용하는 웹후크를 가질 수도 있습니다.
웹훅을 사용하면 대상 서비스는 소스 서비스에 등록(소스 구독)해야만 소스 서비스에서 알고 있는 이벤트에 대한 알림을 받을 수 있습니다. 이 등록은 구성을 통해 수동으로 설정하거나(대역 외) 대상 서비스의 콜백 URL이 포함된 HTTP POST 요청을 통해 자동으로 소스 서비스로 전송할 수 있습니다.
웹훅 메시지는 직렬화되며(일반적으로 텍스트 기반, JSON 또는 XML로 인코딩됨) 소스 서비스에서 이벤트가 발생한 후에 전송됩니다. 대상 서비스는 메시지를 수신하고 성공 상태 코드가 포함된 HTTP 응답으로 이를 확인합니다. 대상 서비스는 소스 서비스로 전송되는 잠재적인 초기 등록 요청과는 별도로 메시지를 요청하지 않고 소스 서비스에서 메시지를 푸시합니다.
참고
웹후크의 소스 및 대상 서비스는 기계(서버)이며, 구성 외에 직접적인 인간 상호 작용은 관여하지 ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month, and much more.
