Thunderbit Open API home page
지원API 콘솔
Distill

여러 페이지 배치 디스틸

POST
/batch/distill
여러 페이지 배치 디스틸

비동기 처리로 여러 웹 페이지를 동시에 디스틸합니다.

사용 사례:

  • 전체 웹사이트 섹션 또는 카테고리 처리
  • 지식 베이스에 콘텐츠 일괄 가져오기
  • 대규모 콘텐츠 마이그레이션
  • 여러 소스에서 주기적인 콘텐츠 업데이트

작동 방식:

  1. 최대 100개의 URL로 배치 작업 제출
  2. 즉시 작업 ID 수신
  3. 상태 엔드포인트 폴링 또는 웹훅 알림 수신
  4. 완료 시 모든 결과 조회

기능:

  • 높은 처리량을 위한 비동기 처리
  • 실패 시 자동 재시도
  • 완료 시 웹훅 알림
  • URL별 상세한 상태 및 오류 보고

인증

YOUR_API_KEY
인증Bearer <token>

Thunderbit Dashboard에서 API 키를 가져오세요. 헤더 형식: Authorization: Bearer YOUR_API_KEY

위치: header

본문

application/json

TypeScript Definitions

Use the request body type in TypeScript.

urls*string[]필수

디스틸할 URL 목록, 최대 100개

예:
[
  "https://example.com/page1",
  "https://example.com/page2",
  "https://example.com/page3"
]
timeoutnumber기본값:30000

요청당 타임아웃(밀리초), 기본값 30000

허용 범위:5000 <= x <= 60000
countryCodestring기본값:"US"

지오타겟팅을 위한 2자리 ISO 국가 코드. 각 URL에 적용됩니다 (기본값: US)

예:US
renderModestring기본값:"none"

각 URL에 적용되는 JavaScript 렌더링 모드: none(기본값), basic, 또는 full

허용 값"none" | "basic" | "full"
includeHtmlboolean기본값:false

각 URL에 대해 원본 HTML을 포함할지 여부 (기본값: false). include 매개변수 사용을 권장합니다.

extractLinksboolean기본값:false

각 URL의 링크를 추출할지 여부 (기본값: false). include 매개변수 사용을 권장합니다.

includestring[]

각 URL에 포함할 선택 필드. 사용 가능한 값: metadata, html, links.

예:
[
  "metadata",
  "links"
]
webhookobject

웹훅. 콜백 설정, 작업 완료 시 알림 콜백 페이로드 형식, 헤더 및 HMAC-SHA256 서명 검증은 Webhooks 가이드를 참조하세요.

하위 속성 표시
urlstring

Webhook callback URL, must be HTTPS

예:https://your-server.com/api/webhook/distill
secretstring

HMAC-SHA256 secret for signature verification. When set, each webhook request includes an X-Webhook-Signature header

예:whsec_your_secret_key
headersobject

Custom headers (reserved for future use, not yet implemented by the server).

예:
{
  "X-Custom-Auth": "your-token"
}

응답

application/json

Success response

successboolean
예:
true
dataobject
하위 속성 표시
idstring

배치 작업 ID

예:batch_abc123
statusstring
허용 값"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
예:PROCESSING
totalinteger
예:
3
completedinteger
예:
0
creditsUsedinteger
예:
0
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)