← PDFtoSCAN Login / Kunin ang API key

Dokumentasyon ng API

Gamitin ang conversion ng PDFtoSCAN mula sa iyong mga application. Lahat ng API request ay nangangailangan ng API key (kumuha ng isa pagkatapos registration).

Base URL

Relatibo sa lahat ng endpoint:

https://pdftoscan.com/api/v1

Authentication

Isama ang iyong API key sa bawat request gamit ang isa sa mga paraang ito:

Header Header X-API-Key: iyong-api-key
Header Header Authorization: Bearer iyong-api-key

Para makakuha ng API key: registration, pagkatapos sa iyong Dashboard bumuo ng bagong key. Isang beses lang ipinapakita ang key—itago nang secure.

I-convert sa mukhang na-scan

POST /convert.php

Mag-upload ng PDF o larawan, o magpadala ng file URL, at makatanggap ng PDF na mukhang na-scan (tagilid, ingay, opsyonal na maruming background, opsyonal na A4).

Request

Paraan: POST
Content-Type: multipart/form-data (o application/x-www-form-urlencoded kapag gumagamit ng file_url lamang maaari mong gamitin ang application/x-www-form-urlencoded)

Mga parameter

Parameter	Uri	Kailangan	Deskripsyon
`file` o `pdf`	file	Hindi	File na PDF, JPG, PNG, TIFF, o WebP na iko-convert (upload). Gumamit ng file o file_url.
`file_url`	string	Hindi	URL na HTTP(S) ng PDF o larawan na iko-convert. Gumamit ng file upload o file_url (max 50 MB, 30 s timeout).
`color_mode`	string	Hindi	color o bw. Default: bw (itim at puti).
`rotate`	number	Hindi	Tagilid ng pahina sa degrees (-1.5 hanggang 1.5). Default: 0.
`noise`	number	Hindi	Dami ng ingay 0–1. Default: 0.1 (10%).
`dirty_background`	string	Hindi	1 (default) para ipakita ang maruming itim na gilid, 0 para i-disable.
`force_a4`	string	Hindi	1 (default) para ilagay output sa A4, 0 para panatilihin ang orihinal na laki.

Response

Tagumpay (200): Ang body ng response ay ang PDF file. I-save o i-stream ang binary content.

Error (4xx/5xx): JSON body: {"ok": false, "error": "Mensahe ng error"}

Mga status code

Code	Kahulugan
200	Tagumpay — ang response ay ang PDF.
400	Masamang request — kulang na file, maling format o upload error.
401	Hindi awtorisado — kulang o invalid na API key.
405	Paraan hindi pinapayagan — gumamit ng POST.
500	Server error — nabigo ang conversion.
503	Hindi available ang serbisyo — hindi available ang conversion sa server.

Mga halimbawa

cURL

Mag-upload ng 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

O magpadala ng file 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

Pinapayagan ang mga request mula sa browser mula sa anumang origin. Suportado ang preflight na OPTIONS request.

Paggamit at mga limitasyon

Bawat conversion ay binibilang bawat API key. Sa iyong dashboard makikita mo ang kabuuang paggamit at paggamit sa huling 7 at 30 araw. Walang built-in na rate limit; maaaring mag-apply ang server upload at resource limit.

Suportadong mga format

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

Output: Laging PDF (na mukhang na-scan).