Webhook 테스트 - 대시보드 도구 및 모니터링

finlight 대시보드는 webhook 통합이 안정적으로 작동하도록 포괄적인 테스트 및 모니터링 도구를 제공합니다. 이러한 내장 기능을 사용하여 webhook 엔드포인트를 검증, 테스트, 디버그하세요.

요약

대시보드 기능 요약

주요 대시보드 도구

Webhook 목록:

구성된 모든 webhook 보기
상태(활성화/비활성화)를 한눈에 확인
webhook 세부 정보에 빠르게 접근

Webhook 세부 정보 페이지:

구성 탭 - webhook 설정 보기/편집
호출 기록 탭 - 모든 전송 시도 보기
테스트 버튼 - 수동 테스트 기능

호출 기록 기능:

상태 필터링 - 성공 또는 실패만 표시
상세 로그 - 항목을 클릭하여 전체 요청/응답 데이터 보기

대시보드관리 인터페이스

Webhook 세부 정보 대시보드

app.finlight.me/news-webhooks에서 webhook 관리 인터페이스에 접속하여 모든 webhook을 보고 관리하세요.

Webhook 세부 정보 접근

대시보드의 webhook 목록으로 이동합니다
webhook의 "Show" 버튼을 클릭하여 세부 정보 페이지를 봅니다
webhook 구성 및 성능에 대한 포괄적인 정보를 확인합니다

webhook 세부 정보 페이지는 다음을 제공합니다:

구성 개요 - 현재 설정 및 필터링 기준
호출 기록 - 모든 webhook 시도의 전체 로그
테스트 컨트롤 - 수동 테스트 기능
편집 컨트롤 - 생성 후 수동 편집

테스트테스트 버튼

수동 테스트

Webhook 테스트 기능

대시보드에는 엔드포인트로 샘플 페이로드를 보내는 "Test" 버튼이 있습니다:

사용 방법:

webhook 세부 정보 페이지를 엽니다
상단 패널의 "Test" 버튼을 클릭합니다
테스트 요청이 완료될 때까지 몇 초 기다립니다
호출 기록에서 테스트 결과를 확인합니다(페이지를 새로 고쳐야 할 수도 있음)

무슨 일이 일어나는가:

구성된 엔드포인트로 실제와 유사한 샘플 페이로드를 보냅니다
실제 인증 설정을 사용합니다
적절한 서명 검증 헤더를 포함합니다
테스트 시도를 호출 기록에 기록합니다

테스트 페이로드: 테스트는 실제 webhook 전송과 동일한 구조를 따르는 모의 기사 이벤트를 보내므로 다음을 검증할 수 있습니다:

엔드포인트 접근성 및 응답
인증 구성
페이로드 처리 로직
오류 처리 능력

기록전송 로그

호출 기록 및 모니터링

호출 기록 보기

webhook 세부 정보 페이지에는 모든 전송 시도를 보여주는 포괄적인 호출 기록이 표시됩니다:

표시되는 정보:

타임스탬프 - webhook이 전송된 시각
상태 - 성공(2xx) 또는 실패(4xx/5xx)
응답 코드 - 엔드포인트가 반환한 HTTP 상태 코드
응답 시간 - 엔드포인트가 응답하는 데 걸린 시간
응답 - "Show"를 클릭하면 드롭다운 콘텐츠 안에 표시되는 전체 응답(헤더 및 본문)

성공 요청 vs 실패 요청

성공 요청 (✅):

HTTP 상태 코드 200-299
타임아웃 기간 내에 수신된 응답
엔드포인트의 적절한 확인

실패 요청 (❌):

HTTP 상태 코드 400-599
네트워크 타임아웃 또는 연결 오류
인증 실패
잘못된 엔드포인트 URL

디버그문제 해결

대시보드를 사용한 디버깅

디버깅에 호출 기록 사용

호출 기록은 webhook 문제를 진단하는 기본 도구입니다:

패턴 식별:

상태로 필터링 - 실패한 요청만 보고 문제를 식별합니다
타임스탬프 확인 - 실패의 시간적 패턴을 찾습니다
응답 코드 검토 - 엔드포인트가 무엇을 반환하는지 파악합니다
재시도 시도 검토 - 전송이 몇 번 시도되었는지 확인합니다

일반적인 실패 지표:

HTTP 401/403 - 인증 또는 권한 부여 문제
HTTP 404 - 잘못된 엔드포인트 URL
HTTP 500 - 애플리케이션의 서버 내부 오류
타임아웃 - 엔드포인트의 응답이 너무 오래 걸림
연결 오류 - 네트워크 연결 문제

상세 오류 정보

호출 기록의 항목을 클릭하면 다음을 볼 수 있습니다:

엔드포인트로 전송된 전체 요청 헤더
엔드포인트에서 수신된 응답 헤더
응답 본문 내용(있는 경우)
정확한 타이밍 정보
실패한 시도의 재시도 기록

요구 사항구현 지침

엔드포인트 요구 사항

응답 요구 사항

webhook 엔드포인트는 다음을 충족해야 합니다:

HTTP 응답:

성공적인 처리에 대해 상태 코드 200-299를 반환
타임아웃을 피하기 위해 30초 이내에 응답
JSON 페이로드가 있는 POST 요청을 수락

헤더:

서명 검증을 위해 X-Webhook-Signature 처리
재생 공격 방지를 위해 X-Webhook-Timestamp 처리
선택한 인증 방법의 헤더 지원

webhook 설정 안내는 webhook 기본 문서를 참조하세요. 인증 세부 정보는 인증 가이드를 확인하세요.