← PDFtoSCAN Pieteikties / Iegūt API atslēgu

API Dokumentācija

Izmantojiet PDFtoSCAN pārveidošanu no savām lietotnēm. Visiem API pieprasījumiem nepieciešama API atslēga (iegūstiet pēc reģistrācijas).

Pamata URL

Visi galapunkti ir relatīvi pret:

https://pdftoscan.com/api/v1

Autentifikācija

Iekļaujiet savu API atslēgu katrā pieprasījumā, izmantojot vienu no šīm metodēm:

Header Galvene X-API-Key: jūsu-api-atslēga
Header Galvene Authorization: Bearer jūsu-api-atslēga

Lai iegūtu API atslēgu: reģistrācijas, pēc tam savā Vadības panelis ģenerējiet jaunu atslēgu. Atslēga tiek rādīta tikai vienu reizi—saglabājiet to droši.

Pārveidot par skenētu izskatu

POST /convert.php

Augšupielādējiet PDF vai attēlu vai nosūtiet faila URL un saņemiet PDF ar skenētu izskatu (slīpums, troksnis, izvēles netīrs fons, izvēles A4).

Pieprasījums

Metode: POST
Content-Type: multipart/form-data (vai application/x-www-form-urlencoded kad izmantojat tikai file_url, varat izmantot application/x-www-form-urlencoded)

Parametri

Parametrs	Tips	Nepieciešams	Apraksts
`file` vai `pdf`	file	Nē	PDF, JPG, PNG, TIFF vai WebP fails pārveidošanai (augšupielāde). Izmantojiet file vai file_url.
`file_url`	string	Nē	HTTP(S) URL PDF vai attēlam pārveidošanai. Izmantojiet faila augšupielādi vai file_url (maks. 50 MB, 30 s noilgums).
`color_mode`	string	Nē	color vai bw. Noklusējums: bw (melnbalts).
`rotate`	number	Nē	Lapas slīpums grādos (-1.5 līdz 1.5). Noklusējums: 0.
`noise`	number	Nē	Trokšņa daudzums 0–1. Noklusējums: 0.1 (10%).
`dirty_background`	string	Nē	1 (noklusējums) rādīt netīras melnas malas, 0 atspējot.
`force_a4`	string	Nē	1 (noklusējums) pielāgot izvadi A4, 0 saglabāt oriģinālo izmēru.

Atbilde

Veiksmīgi (200): Atbildes saturs ir PDF fails. Saglabājiet vai straumējiet bināro saturu.

Kļūda (4xx/5xx): JSON saturs: {"ok": false, "error": "Kļūdas ziņojums"}

Statusa kodi

Code	Nozīme
200	Veiksmīgi — atbilde ir PDF.
400	Slikts pieprasījums — trūkst faila, nepareizs formāts vai augšupielādes kļūda.
401	Neautorizēts — trūkst vai nederīga API atslēga.
405	Metode nav atļauta — izmantojiet POST.
500	Servera kļūda — pārveidošana neizdevās.
503	Pakalpojums nav pieejams — pārveidošana nav pieejama serverī.

Piemēri

cURL

Augšupielādēt failu:

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

Vai nosūtīt faila 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

Pieprasījumi no pārlūkprogrammām ir atļauti no jebkuras izcelsmes. Tiek atbalstīti preflight OPTIONS pieprasījumi.

Lietošana un ierobežojumi

Katra pārveidošana tiek skaitīta uz API atslēgu. Savā vadības panelī varat redzēt kopējo lietošanu un lietošanu pēdējo 7 un 30 dienu laikā. Nav iebūvētu ātruma ierobežojumu; var tikt piemēroti servera augšupielādes un resursu ierobežojumi.

Atbalstītie formāti

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

Izvade: Vienmēr PDF (ar skenētu izskatu).