← PDFtoSCAN Koneksyon / Jwenn kle API

Dokimantasyon API

Sèvi ak konvèsyon PDFtoSCAN nan aplikasyon ou. Tout demann API egzije yon kle API (jwenn yon sèl apre enskripsyon).

URL baz

Tout endpoint relatif a:

https://pdftoscan.com/api/v1

Otantifikasyon

Mete kle API ou nan chak demann lè w sèvi ak youn nan metòd sa yo:

Header Header X-API-Key: kle-api-ou
Header Header Authorization: Bearer kle-api-ou

Pou jwenn yon kle API: enskripsyon, epi nan Tablo bò ou jenere yon nouvo kle. Kle a montre yon sèl fwa—estoke li an sekirite.

Konvèti an gade eskane

POST /convert.php

Monte yon PDF oubyen imaj, oubyen voye yon URL dosye, epi resevwa yon PDF ak aparans eskane (enklinasyon, bri, background sal opsyonèl, A4 opsyonèl).

Demann

Metòd: POST
Content-Type: multipart/form-data (oubyen application/x-www-form-urlencoded lè w sèvi ak file_url sèlman ou ka sèvi ak application/x-www-form-urlencoded)

Paramèt

Paramèt	Kalite	Obligatwa	Deskripsyon
`file` oubyen `pdf`	file	Non	Dosye PDF, JPG, PNG, TIFF oubyen WebP pou konvèti (monte). Sèvi ak file oubyen file_url.
`file_url`	string	Non	URL HTTP(S) yon PDF oubyen imaj pou konvèti. Sèvi ak monte dosye oubyen file_url (maks 50 MB, timeout 30 s).
`color_mode`	string	Non	color oubyen bw. Default: bw (nwa ak blan).
`rotate`	number	Non	Enklinasyon paj an degre (-1.5 a 1.5). Default: 0.
`noise`	number	Non	Kantite bri 0–1. Default: 0.1 (10%).
`dirty_background`	string	Non	1 (default) pou montre bò nwa sal, 0 pou enfim.
`force_a4`	string	Non	1 (default) pou adapte output nan A4, 0 pou kenbe gwosè orijinal.

Repons

Siksè (200): Kò repons lan se dosye PDF la. Sove oubyen stream kontni binè.

Erè (4xx/5xx): Kò JSON: {"ok": false, "error": "Mesaj erè"}

Kòd estati

Code	Siynifikasyon
200	Siksè — repons lan se PDF.
400	Move demann — dosye mankan, move fòma oubyen erè monte.
401	Pa otorize — kle API mankan oubyen envalid.
405	Metòd pa otorize — sèvi ak POST.
500	Erè sèvè — konvèsyon echwe.
503	Sèvis pa disponib — konvèsyon pa disponib sou sèvè.

Egzanp

cURL

Monte yon dosye:

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

Oubyen voye yon URL dosye:

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

Demann ki soti nan navigatè otorize nan nenpòt orijin. Demann OPTIONS preflight sipòte.

Itilizasyon ak limit

Chak konvèsyon konte pa kle API. Nan tablo bò ou ou ka wè total itilizasyon ak itilizasyon sou 7 ak 30 dènye jou. Pa gen limit pousantaj entegre; limit monte ak resous sèvè ka aplike.

Fòma sipòte

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

Output: Toujou PDF (ak gade eskane).