이 페이지는 기계 번역되었습니다. 영어 버전이 원본이며 더 정확하거나 최신일 수 있습니다. 영어로 보기

속도 제한 및 할당량

모든 finlight API 키는 플랜에 연결되어 있으며, 플랜은 사용 제한과 접근 가능한 기능을 정의합니다. 제한은 API 키별로 실시간으로 적용됩니다. 이 페이지에서는 각 제한과 각 플랜이 잠금 해제하는 내용을 설명합니다. 플랜의 정확한 수치는 finlight 대시보드 또는 요금 페이지를 참조하세요.

네 가지 사용 제한

  • Name
    월간 요청 할당량
    Description

    각 REST 요청은 월간 허용량에서 하나의 요청을 소비합니다. 카운터는 각 청구 주기가 시작될 때 재설정됩니다. 초과하면 429가 "Exceeded token limit of N for the current period." 메시지와 함께 반환됩니다.

  • Name
    버스트 속도
    Description

    10초당 요청 수에 대한 단기 제한으로, 급증을 완화합니다. 이를 정의한 플랜에서만 적용됩니다. 초과하면 429가 "Exceeded rate limit of N requests per 10 seconds." 메시지와 함께 반환됩니다. 약 10초 대기 후 다시 시도하세요.

  • Name
    WebSocket 연결
    Description

    키에 대한 동시 WebSocket 연결의 최대 수입니다. 제한을 초과하는 새 연결은 거부됩니다. 별도의 상한이 주기당 스트리밍되는 총 메시지 수를 제한합니다. WebSocket에는 유료 플랜이 필요합니다.

  • Name
    Webhook 전송 할당량
    Description

    청구 주기당 webhook 전송의 최대 수입니다. 함께 적용되는 제한이 생성할 수 있는 webhook 수를 제한합니다. 전송 할당량이 소진되면 다음 주기까지 전송이 일시 중지됩니다.

플랜이 잠금 해제하는 기능

원시 제한 외에도 플랜은 어떤 기능을 사용할 수 있는지 제어합니다. 플랜에 포함되지 않은 기능을 요청하면 (REST의 경우) 403이 반환되거나 (webhook/WebSocket의 경우) 데이터가 단순히 생략됩니다.

  • Name
    과거 데이터
    Description

    얼마나 과거까지 조회할 수 있는지는 플랜에 따라 다릅니다. Free 및 Pro Light 플랜은 현재 대략 최근 한 달의 기사를 다루며, 상위 플랜은 더 깊은 과거 범위를 잠금 해제합니다. from / to 날짜 필터를 사용하여 플랜의 기간 내에서 조회하세요. 그 범위를 벗어난 날짜에 대한 요청은 해당 범위에 대해 결과를 반환하지 않습니다. 각 플랜의 정확한 기록 기간은 요금 페이지를 참조하세요.

  • Name
    감성 분석
    Description

    기사의 sentiment 및 confidence 필드를 포함합니다. 부여되지 않으면 페이로드에서 제거됩니다.

  • Name
    회사 엔티티
    Description

    companies 배열(AI가 분석한 티커, ISIN, 거래소 등)을 포함하고 includeEntities를 활성화합니다. 부여되지 않으면 제거됩니다.

  • Name
    사용자 지정 소스
    Description

    기본 세트에 추가된 비공개 또는 고객 전용 뉴스 소스입니다. 상위 / 엔터프라이즈 플랜에서 제공됩니다.

적용 방식

  • 키별로 실시간. 각 요청이 카운터를 증가시키며, 제한을 초과하는 즉시 API가 429를 반환합니다.
  • 대시보드 사용량은 실시간이 아닙니다. finlight 대시보드에 표시되는 사용량은 약 하루에 한 번 집계되며 전날까지의 활동을 반영합니다. 실시간 카운터가 아닙니다. 적용은 실시간이므로 오늘의 실제 남은 할당량은 대시보드에 표시된 것과 다를 수 있습니다.
  • 월간 카운터 재설정은 청구 주기가 시작될 때 이루어지며, 할당량 429는 자동으로 해제됩니다.
  • 속도 제한 헤더 없음. finlight는 현재 Retry-After 또는 X-RateLimit-* 헤더를 보내지 않습니다. 버스트 429는 "약 10초 대기"로, 월간 429는 "이 주기의 할당량 도달"로 간주하세요. 오류 및 상태 코드를 참조하세요.

플랜

플랜일반적인 용도
Free평가 및 소량 사용. REST 전용(WebSocket 없음).
Pro (Light / Standard / Scale)할당량이 점차 증가하는 프로덕션 워크로드. WebSocket, webhook, 더 풍부한 보강 포함.
Enterprise대용량, 사용자 지정 소스, 맞춤형 제한.

정확한 수치 제한(월간 토큰, 버스트 속도, WebSocket 연결, webhook 할당량)과 플랜별 기능 세트는 요금의 일부이며 변경될 수 있습니다. 항상 finlight 대시보드에서 현재 플랜의 제한을 확인하거나 요금 페이지에서 플랜을 비교하세요. 더 높은 제한이나 사용자 지정 소스가 필요하신가요? 문의하기.

제한에 도달했을 때

  • 버스트 429 → 약 10초 일시 중지한 후 계속합니다.
  • 월간 할당량 429 → 이번 주기의 요청을 모두 사용했습니다. 업그레이드하거나 재설정을 기다리세요.
  • WebSocket 연결 거부 → 동시 연결 상한에 도달했습니다. 유휴 연결을 닫으세요(WebSocket 빠른 시작의 takeover 옵션 참조).
  • Webhook 전송 일시 중지 → 이번 주기의 전송 할당량이 소진되었습니다. 다음 주기에 재개됩니다.
  • 기능에 대한 403 → 해당 기능이 플랜에 없습니다. 위 표를 참조하세요.

정확한 오류 본문은 오류 및 상태 코드를 참조하세요.