PDF Craft API는 REST 기반이며 JSON 요청과 응답을 사용하고 Bearer API 키로 각 요청을 인증합니다.
기본 URL 및 인증
모든 엔드포인트는 https://fusion-api.oomol.com/v1 아래에 있습니다. Authorization 요청 헤더로 API 키를 전송하세요.
text
Authorization: Bearer YOUR_API_KEY
프런트엔드 코드에 이 키를 노출하지 마세요. 최종 사용자가 변환을 시작할 때는 브라우저에서 발생한 요청을 자체 백엔드를 통해 처리하세요.
비동기 작업 수명 주기
문서 변환은 비동기로 처리됩니다. 제출 엔드포인트는 작업 식별자인 sessionID를 반환하며, 해당 결과 엔드포인트는 다음 상태 중 하나를 보고합니다.
processing: 파일이 대기 중이거나 변환 중입니다.completed: 결과에 생성된 출력 URL인data.downloadURL과 메타데이터가 포함됩니다.failed: 결과에 실패 원인이 포함됩니다. 애플리케이션에서 이를 표시하거나 기록해야 합니다.
작업이 최종 상태에 도달하면 폴링을 중지하고 재시도 횟수를 제한하세요. 지원 및 복구를 위해 작업 ID를 보관하세요.
엔드포인트
현재 API는 PDF를 Markdown 및 EPUB으로 변환하는 기능을 지원합니다. 엔드포인트 경로, 매개변수, 페이로드 예시, Python SDK 및 TypeScript SDK 사용 방법은 전체 API 참조를 확인하세요.