# API 개념

[HTML](https://pdfcraft.ai/ko-KR/docs/api/overview/) · [Site index](https://pdfcraft.ai/llms.txt)

인증, 비동기 작업, 문서 변환 API의 수명 주기를 알아보세요.


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 참조](https://pdfcraft.ai/ko-KR/api/)를 확인하세요.