← PDFtoSCAN Masuk / Dapatkan kunci API

Dokumentasi API

Gunakan konversi PDFtoSCAN dari aplikasi Anda. Semua permintaan API memerlukan kunci API (dapatkan setelah pendaftaran).

URL dasar

Semua endpoint relatif terhadap:

https://pdftoscan.com/api/v1

Autentikasi

Sertakan kunci API Anda di setiap permintaan menggunakan salah satu metode ini:

Header Header X-API-Key: kunci-api-anda
Header Header Authorization: Bearer kunci-api-anda

Untuk mendapatkan kunci API: pendaftaran, kemudian di Dasbor Anda buat kunci baru. Kunci hanya ditampilkan sekali—simpan dengan aman.

Konversi ke tampilan dipindai

POST /convert.php

Unggah PDF atau gambar, atau kirim URL file, dan terima PDF dengan tampilan dipindai (miring, noise, latar belakang kotor opsional, A4 opsional).

Permintaan

Metode: POST
Content-Type: multipart/form-data (atau application/x-www-form-urlencoded saat menggunakan file_url saja Anda dapat menggunakan application/x-www-form-urlencoded)

Parameter

Parameter	Tipe	Wajib	Deskripsi
`file` atau `pdf`	file	Tidak	File PDF, JPG, PNG, TIFF atau WebP untuk dikonversi (unggah). Gunakan file atau file_url.
`file_url`	string	Tidak	URL HTTP(S) dari PDF atau gambar untuk dikonversi. Gunakan unggah file atau file_url (maks. 50 MB, timeout 30 detik).
`color_mode`	string	Tidak	color atau bw. Default: bw (hitam putih).
`rotate`	number	Tidak	Kemiringan halaman dalam derajat (-1.5 hingga 1.5). Default: 0.
`noise`	number	Tidak	Jumlah noise 0–1. Default: 0.1 (10%).
`dirty_background`	string	Tidak	1 (default) untuk menampilkan tepi hitam kotor, 0 untuk menonaktifkan.
`force_a4`	string	Tidak	1 (default) untuk menyesuaikan output ke A4, 0 untuk mempertahankan ukuran asli.

Respons

Berhasil (200): Isi respons adalah file PDF. Simpan atau streaming konten biner.

Kesalahan (4xx/5xx): Isi JSON: {"ok": false, "error": "Pesan kesalahan"}

Kode status

Code	Arti
200	Berhasil — respons adalah PDF.
400	Permintaan buruk — file hilang, format salah atau kesalahan unggah.
401	Tidak sah — kunci API hilang atau tidak valid.
405	Metode tidak diizinkan — gunakan POST.
500	Kesalahan server — konversi gagal.
503	Layanan tidak tersedia — konversi tidak tersedia di server.

Contoh

cURL

Unggah file:

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

Atau kirim URL file:

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

Permintaan dari browser diizinkan dari asal mana pun. Permintaan OPTIONS preflight didukung.

Penggunaan dan batasan

Setiap konversi dihitung per kunci API. Di dasbor Anda dapat melihat total penggunaan dan penggunaan selama 7 dan 30 hari terakhir. Tidak ada batasan laju bawaan; batasan unggah server dan sumber daya mungkin berlaku.

Format yang didukung

Input: PDF, JPG, JPEG, PNG, TIFF, WebP.

Output: Selalu PDF (dengan tampilan dipindai).