빠른 시작
속보가 발생하면 즉시 알림을 받으세요. Webhook은 실시간 기사 업데이트를 애플리케이션으로 직접 전송하여 지속적인 API 폴링의 필요성을 없애줍니다.
Webhook이란?
Webhook을 애플리케이션을 위한 즉각적인 알림이라고 생각하세요. 귀하의 기준에 맞는 뉴스가 발생하면 finlight는 즉시 기사 데이터를 지정한 엔드포인트로 보냅니다.
Webhook의 작동 방식
간단히 말하면 전체 흐름은 다음과 같습니다:
- 구성 - 특정 뉴스 기준으로 webhook을 설정합니다
- 모니터링 - 저희 시스템이 연중무휴 24시간 새 기사를 감시합니다
- 매칭 - 기사가 귀하의 기준을 충족하면 즉시 감지합니다
- 전송 - 기사 데이터를 귀하의 엔드포인트로 직접 보냅니다
이 "리버스 API" 방식은 반복적으로 요청하는 대신, 업데이트가 발생하는 순간 앱이 이를 받도록 합니다.
시작하기
필요한 것
첫 webhook을 만들기 전에 다음을 갖추었는지 확인하세요:
- webhook 액세스가 포함된 활성 finlight 구독
- webhook 호출을 받을 준비가 된 공개 HTTPS 엔드포인트
- app.finlight.me의 대시보드 액세스
빠른 액세스
app.finlight.me/news-webhooks를 방문하여 finlight 계정에 로그인하면 webhook 생성으로 바로 이동합니다.
첫 Webhook 만들기
이 간단한 4단계 과정을 따라 webhook을 설정하고 실시간 뉴스 업데이트 수신을 시작하세요.
1단계: Webhook 생성기에 접속
- app.finlight.me에서 finlight 대시보드에 로그인합니다
- 기본 메뉴에서 **"Webhooks"**로 이동합니다
- 설정 마법사를 시작하려면 **"New Webhook"**을 클릭합니다
2단계: 기본 정보
webhook에 명확한 식별 정보를 부여하고 전송 유형을 선택합니다:
- 이름 - "속보 테크 뉴스" 또는 "시장 업데이트"처럼 설명이 분명한 이름을 선택하세요
- 설명 - webhook의 목적에 대한 선택적 간단 설명
- 전송 유형 - 기사를 어떻게 전송할지 선택합니다:
- 보강 (기본값) — 회사 데이터, 감성, 전체 필터링 옵션이 포함된 AI 처리 페이로드. 보강된 Webhook 가이드를 참조하세요.
- 원시 — 더 빠른 전송, 단순화된 페이로드, 제한된 필터. 원시 Webhook 가이드를 참조하세요.
3단계: 뉴스 기준 정의
관련 기사만 받도록 필터링을 구성하세요. 사용 가능한 옵션은 선택한 전송 유형에 따라 다릅니다.
해당 유형의 전체 필터 참조는 보강된 Webhook 또는 원시 Webhook을 참조하세요.
4단계: 대상 및 보안 설정
Webhook 대상
뉴스를 보낼 엔드포인트 URL을 입력하세요:
- 공개 HTTPS URL이어야 합니다
- 빠르게 응답해야 합니다(5초 미만)
보안 설정
webhook 엔드포인트를 보호하는 방법을 선택하세요:
- 없음 - 추가 인증 없음(프로덕션에는 권장하지 않음)
- 기본 인증 - HTTP Basic Auth를 통한 사용자 이름/비밀번호 보호
- 사용자 지정 헤더 -
X-Finlight-Key헤더로 API 키를 전송 - 서명 검증 -
X-Webhook-Signature헤더를 통한 페이로드 검증을 위해 항상 포함됨
참고: 선택한 인증 방법과 관계없이, 페이로드 무결성 검증을 위해 모든 webhook에서 서명 검증이 자동으로 활성화됩니다.
이러한 보안 옵션 구현에 대해 인증 가이드에서 자세히 알아보세요.
통합 테스트
내장 테스트 도구
라이브 전환 전에 webhook 설정을 검증하세요:
- 대시보드 테스트 기능 - 엔드포인트로 샘플 페이로드를 보냅니다
- 전송 모니터링 - 성공률과 응답 시간을 추적합니다
- 오류 진단 - 실패한 전송을 디버그합니다
포괄적인 테스트 지침, 페이로드 예제, 문제 해결 팁은 webhook 테스트 가이드를 참조하세요.
도움이 필요하신가요?
빠른 지원 옵션
페이로드 및 필터링
해당 유형의 기사 모델과 필터 참조는 보강된 Webhook 또는 원시 Webhook을 참조하세요.
기술 설정
자세한 구현 도움말은 인증 가이드와 테스트 가이드를 참조하세요.
일반 지원
추가 리소스와 연락처 정보는 지원 페이지를 확인하세요.
대시보드 문제
app.finlight.me에서 webhook 관리에 접속하거나 플랫폼을 통해 지원에 문의하세요.
시작할 준비가 되셨나요?
Webhook은 뉴스 업데이트를 받는 방식을 바꿔놓습니다 - 몇 분마다 폴링하던 것에서 뉴스가 발생하는 순간의 즉각적인 전송으로.
기본 필터링 기준으로 간단하게 시작한 다음, 애플리케이션에 가장 적합한 것을 찾아가며 점진적으로 확장하세요. finlight 대시보드를 사용하면 언제든지 webhook을 손쉽게 수정하고 최적화할 수 있습니다.