본문으로 건너뛰기
이 페이지는 AI로 번역되었으며 오류가 있을 수 있습니다.

Webhook

맞춤 Webhook으로 독서 이벤트를 원하는 URL로 전송합니다. 독자적인 자동화 및 연동 구축에 적합합니다.

Book Reading Habit app showing webhook configuration screen

Webhook 설정 화면

Webhook을 사용하면 독서 활동에 대한 실시간 알림을 받을 수 있습니다. 이벤트가 발생하면 Book Reading Habit이 JSON 형식의 이벤트 데이터를 지정한 URL로 HTTP POST 요청으로 전송합니다.

Webhook이란?

Webhook을 사용하면 독서 활동에 대한 실시간 알림을 받을 수 있습니다. 이벤트가 발생하면 Book Reading Habit이 JSON 형식의 이벤트 데이터를 지정한 URL로 HTTP POST 요청으로 전송합니다.

Webhook 작동 방식

Webhook URL을 설정하면 특정 이벤트가 발생할 때마다 Book Reading Habit이 자동으로 알림을 전송합니다:

  • Book Reading Habit에서 이벤트 발생 (예: 독서 세션 완료)
  • 앱이 Webhook URL로 HTTP POST 요청 전송
  • 서버가 JSON 페이로드를 수신하고 원하는 방식으로 처리 가능

설정

다음 설정으로 Webhook을 구성하세요:

Webhook 이름

이 Webhook을 식별하기 위한 이름

Webhook URL

POST 요청이 전송될 URL

시크릿 키 (선택 사항)

지정하면 요청에 검증용 HMAC 서명이 포함된 X-Signature-256 헤더가 포함됩니다

이벤트

이 Webhook을 트리거할 이벤트를 선택하세요

페이로드 형식

모든 Webhook 페이로드는 다음 구조의 JSON으로 전송됩니다:

{
  "eventType": "session.completed",
  "timestamp": "2024-12-04T10:30:00Z",
  "book": { ... },
  "session": { ... },
  "metadata": null
}

자세히 보기

보안 모범 사례

항상 HTTPS URL을 사용하고 Webhook 요청을 검증하기 위한 시크릿 키를 설정하세요. 시크릿 키는 서버에서 검증할 수 있는 HMAC 서명을 생성하는 데 사용됩니다.