원시 Webhook

원시 Webhook은 표준(보강된) webhook에 대한 경량의 빠른 전송 대안입니다. 기사가 게시되는 즉시 핵심 기사 데이터를 전송하며, AI 보강 파이프라인을 완전히 건너뜁니다.

보강된 Webhook과의 주요 차이점:

더 빠른 전송 — 기사는 수집되는 즉시 푸시되며, 감성 분석, 엔티티 해석, 회사 매칭을 기다리지 않습니다.
단순화된 필터 — query, sources, excludeSources, language, includeUpdates만 지원됩니다. tickers, countries, categories, includeContent, includeEntities, excludeEmptyContent는 사용할 수 없습니다.
AI 보강 없음 — 페이로드에 sentiment, confidence, companies 데이터가 포함되지 않습니다.
query 필드 수준 필터링 — query 매개변수는 source, title, summary에 한해 필드 수준 구문을 지원합니다.
변경 불가 유형 — 전송 유형(raw 또는 enriched)은 생성 시 설정되며 이후 변경할 수 없습니다.

기사 모델

원시 Webhook은 단순화된 기사 페이로드를 전송합니다. 회사 엔티티, 감성 점수, AI 생성 보강 정보는 포함되지 않습니다.

Name
link
Type
string
Description
전체 기사로의 URL.
Name
source
Type
string
Description
출처 웹사이트. 예: www.reuters.com
Name
title
Type
string
Description
기사 제목.
Name
summary
Type
string
Description
기사 요약(있는 경우). null일 수 있습니다.
Name
publishDate
Type
Date
Description
게시 날짜(ISO 8601 날짜 문자열).
Name
createdAt
Type
Date
Description
finlight 시스템에서 기사의 내부 생성 날짜(ISO 8601 날짜 문자열).
Name
revisedDate
Type
Date | null
Description
최초 게시 이후 기사가 마지막으로 수정된 날짜. 기사가 한 번도 수정되지 않은 경우 null. includeUpdates가 활성화되고 기사가 수정된 경우에 존재합니다.
Name
isUpdate
Type
boolean
Description
이 전송이 게시 후 업데이트에 의해 트리거된 경우 true. includeUpdates가 활성화된 경우에만 존재합니다.
Name
language
Type
string
Description
ISO 639-1 언어 코드. 예: en | de | fr
Name
images
Type
string[]
Description
기사의 이미지 URL 배열.
Name
countries
Type
string[]
Description
ISO 3166-1 alpha-2 형식의 국가 코드 배열. 예: ["US", "GB"]. 비어 있을 수 있습니다.
Name
categories
Type
string[]
Description
기사 카테고리 배열. 가능한 값: markets | economy | business | politics | geopolitics | regulation | technology | energy | commodities | crypto | health | climate | security. 비어 있을 수 있습니다.

WEBHOOK전송 유형

원시 Webhook 만들기

finlight 대시보드에서 webhook을 만들 때 설정 마법사의 첫 단계에서 전송 유형으로 Raw를 선택하세요. 그러면 기준 단계에는 지원되는 네 가지 필터 매개변수만 표시됩니다.

원시 Webhook은 귀하의 기준에 맞는 새로 게시된 기사만 전송합니다. 각 전송은 HTTP POST 요청으로 엔드포인트에 전송되는 단일 기사 페이로드입니다.

Name
query
Type
string
Description
관련 기사를 찾기 위한 검색 쿼리. source, title, summary 필드에 대한 필드 수준 필터링을 지원합니다. 아래의 query 필드 수준 필터링을 참조하세요.
Name
sources
Type
string[]
Description
전송을 특정 출처의 기사로 제한합니다. 예: ["www.reuters.com", "www.cnbc.com"]. 유효한 값은 sources 엔드포인트를 참조하세요.
Name
excludeSources
Type
string[]
Description
특정 출처의 기사를 제외합니다. 예: ["www.example.com"].
Name
language
Type
string
Description
기사 언어로 필터링합니다(ISO 639-1). 기본값은 en으로, 영어만 반환하고 다른 언어는 제외합니다 — 언어 및 범위를 참조하세요.
Name
includeUpdates
Type
boolean
Description
기사가 최초 게시 후 업데이트될 때 다시 전송합니다. 업데이트된 페이로드에는 isUpdate=true와 revisedDate 타임스탬프가 포함됩니다.

Response

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs",
  "summary": "A brief summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "language": "en",
  "images": [
    "https://www.example.com/image1.jpg",
    "https://www.example.com/image2.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"]
}

Response (includeUpdates: true)

{
  "link": "https://www.example.com/article1",
  "source": "www.example.com",
  "title": "Stock Market Hits New Highs — Updated",
  "summary": "An updated summary of the article...",
  "publishDate": "2023-10-01T12:34:56Z",
  "createdAt": "2023-10-01T12:35:10Z",
  "revisedDate": "2023-10-02T08:00:00Z",
  "isUpdate": true,
  "language": "en",
  "images": [
    "https://www.example.com/image1.jpg"
  ],
  "countries": ["US"],
  "categories": ["markets"]
}

query 필드 수준 필터링

원시 Webhook의 query 매개변수는 다음 필드에 한해 필드 수준 필터링을 지원합니다:

source - 기사 출처 도메인으로 필터링
title - 기사 제목 내용으로 필터링
summary - 기사 요약 내용으로 필터링

예시:

query=title:Nvidia

제목에 "Nvidia"가 포함된 기사를 전송합니다.

query=summary:earnings +title:Tesla

요약에 "earnings"가 언급되고 제목에 "Tesla"가 포함된 기사를 전송합니다.

query=source:www.reuters.com -crypto

Reuters의 기사를 전송하되 "crypto"를 언급하는 기사는 제외합니다.

쿼리 구문의 전체 참조는 고급 쿼리 작성 가이드를 참조하세요.

GUIDE결정 도움말

원시 Webhook을 사용해야 할 때

다음의 경우 Raw를 선택하세요:

가능한 한 낮은 전송 지연이 필요한 경우
보강 데이터가 필요 없는 고처리량 파이프라인을 구축하는 경우
키워드, 출처, 언어로만 필터링하면 되는 경우
자체 처리 오버헤드를 줄이기 위해 더 가벼운 페이로드를 원하는 경우

다음의 경우 Enriched를 선택하세요:

회사/티커 수준의 필터링이 필요한 경우(tickers, countries, categories)
페이로드에 감성 점수, 신뢰도 값 또는 엔티티 해석이 필요한 경우
includeContent / includeEntities를 통해 전체 기사 내용이나 추출된 엔티티를 포함해야 하는 경우
주식 모니터링, 실적 추적 또는 섹터별 뉴스 피드를 구축하는 경우

보강된 webhook 필터링 옵션에 대한 자세한 내용은 필터링 기준 가이드를 참조하세요.