← PDFtoSCAN 로그인 / API 키 받기

API 문서

애플리케이션에서 PDFtoSCAN 변환을 사용하세요. 모든 API 요청에는 API 키가 필요합니다(등록 후 받기).

기본 URL

모든 엔드포인트는 다음에 상대적입니다:

https://pdftoscan.com/api/v1

인증

다음 방법 중 하나를 사용하여 모든 요청에 API 키를 포함하세요:

Header 헤더 X-API-Key: your-api-key
Header 헤더 Authorization: Bearer your-api-key

API 키를 받으려면: 등록, 그런 다음 대시보드에서 새 키를 생성하세요. 키는 한 번만 표시됩니다—안전하게 보관하세요.

스캔된 모양으로 변환

POST /convert.php

PDF 또는 이미지를 업로드하거나 파일 URL을 보내고 스캔된 모양의 PDF(기울기, 노이즈, 선택적 더러운 배경, 선택적 A4)를 받으세요.

요청

메서드: POST
Content-Type: multipart/form-data (또는 application/x-www-form-urlencoded file_url만 사용할 때 application/x-www-form-urlencoded를 사용할 수 있습니다)

매개변수

매개변수	유형	필수	설명
`file` 또는 `pdf`	file	아니오	변환할 PDF, JPG, PNG, TIFF 또는 WebP 파일(업로드). file 또는 file_url을 사용하세요.
`file_url`	string	아니오	변환할 PDF 또는 이미지의 HTTP(S) URL. 파일 업로드 또는 file_url(최대 50MB, 30초 타임아웃)을 사용하세요.
`color_mode`	string	아니오	color 또는 bw. 기본값: bw(흑백).
`rotate`	number	아니오	페이지 기울기(도)(-1.5~1.5). 기본값: 0.
`noise`	number	아니오	노이즈 양 0–1. 기본값: 0.1(10%).
`dirty_background`	string	아니오	1(기본값)은 더러운 검은 가장자리 표시, 0은 비활성화.
`force_a4`	string	아니오	1(기본값)은 A4에 출력 맞춤, 0은 원래 크기 유지.

응답

성공(200): 응답 본문은 PDF 파일입니다. 바이너리 콘텐츠를 저장하거나 스트리밍하세요.

오류(4xx/5xx): JSON 본문: {"ok": false, "error": "오류 메시지"}

상태 코드

Code	의미
200	성공 — 응답은 PDF입니다.
400	잘못된 요청 — 파일 누락, 잘못된 형식 또는 업로드 오류.
401	권한 없음 — API 키 누락 또는 유효하지 않음.
405	메서드 허용되지 않음 — POST를 사용하세요.
500	서버 오류 — 변환 실패.
503	서비스 사용 불가 — 서버에서 변환을 사용할 수 없음.

예제

cURL

파일 업로드:

curl -X POST "https://pdftoscan.com/api/v1/convert.php" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "color_mode=bw" \
  -F "force_a4=1" \
  -o scanned.pdf

또는 파일 URL 보내기:

curl -X POST "https://pdftoscan.com/api/v1/convert.php" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d "file_url=https://example.com/document.pdf" \
  -d "color_mode=bw" \
  -d "force_a4=1" \
  -o scanned.pdf

JavaScript (fetch)

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('color_mode', 'bw');
formData.append('force_a4', '1');

const response = await fetch('https://pdftoscan.com/api/v1/convert.php', {
  method: 'POST',
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
  body: formData
});

if (!response.ok) {
  const err = await response.json();
  throw new Error(err.error || 'Request failed');
}
const blob = await response.blob();
// e.g. save or open blob as PDF

Python

import requests

url = 'https://pdftoscan.com/api/v1/convert.php'
headers = {'X-API-Key': 'YOUR_API_KEY'}
files = {'file': open('document.pdf', 'rb')}
data = {'color_mode': 'bw', 'force_a4': '1'}

r = requests.post(url, headers=headers, files=files, data=data)

if r.status_code != 200:
    print(r.json().get('error', 'Error'))
else:
    with open('scanned.pdf', 'wb') as f:
        f.write(r.content)

CORS

브라우저의 요청은 모든 출처에서 허용됩니다. 프리플라이트 OPTIONS 요청이 지원됩니다.

사용량 및 제한

각 변환은 API 키당 계산됩니다. 대시보드에서 총 사용량과 최근 7일 및 30일 사용량을 볼 수 있습니다. 내장된 속도 제한이 없습니다. 서버 업로드 및 리소스 제한이 적용될 수 있습니다.

지원 형식

입력: PDF, JPG, JPEG, PNG, TIFF, WebP.

출력: 항상 PDF(스캔된 모양).