본문으로 건너뛰기
용어 사전

웹훅이란 무엇인가요?

웹훅(webhook)은 근무표 승인 같은 특정 이벤트가 일어나는 즉시 한 시스템이 다른 시스템의 URL로 보내는 자동 HTTP 요청입니다. 받는 시스템은 폴링 없이 바로 대응할 수 있습니다.

웹훅의 작동 방식

URL을 등록하고 관심 있는 이벤트를 고릅니다. 그 이벤트가 발생하면 보내는 시스템이 무슨 일이 일어났는지 설명하는 작은 JSON 메시지를 그 URL로 전송합니다. 받는 쪽이 다운되어 있으면 좋은 발신 시스템은 나중에 다시 시도합니다.

공개 URL에는 누구든 요청을 보낼 수 있으므로 웹훅에는 서명이 붙습니다. 발신자는 공유 비밀 키로 메시지에 대한 HMAC 서명을 계산하고, 수신자는 이를 다시 계산해 서명이 일치하는 메시지만 신뢰합니다.

TimeTracking의 웹훅

TimeTracking은 근무 시간의 상태가 바뀔 때 HMAC으로 서명된 웹훅을 보내며, 실패하면 재시도합니다. CRM을 업데이트하거나, 청구 처리를 시작하거나, 채팅 채널에 메시지를 게시하는 데 쓸 수 있습니다. 반대 방향, 즉 필요할 때 데이터를 읽고 쓰는 일은 OpenAPI 명세를 갖춘 REST API가 담당합니다.

TimeTracking을 무료로 사용해 보세요

5명까지 무료. Core는 사용자당 월 €1부터, 모든 기능 포함.