← PDFtoSCAN Inloggen / API-sleutel verkrijgen

API-documentatie

Gebruik de PDFtoSCAN-conversie vanuit uw applicaties. Alle API-verzoeken vereisen een API-sleutel (verkrijg er een na registratie).

Basis-URL

Alle eindpunten zijn relatief ten opzichte van:

https://pdftoscan.com/api/v1

Authenticatie

Neem uw API-sleutel op in elk verzoek met een van deze methoden:

Header Header X-API-Key: uw-api-sleutel
Header Header Authorization: Bearer uw-api-sleutel

Om een API-sleutel te verkrijgen: registratie, genereer vervolgens in uw Dashboard een nieuwe sleutel. De sleutel wordt slechts één keer getoond—bewaar deze veilig.

Skakel om na geskandeerde voorkoms

POST /convert.php

Laai 'n PDF of afbeelding, of stuur 'n lêers-URL, en ontvang 'n PDF met geskandeerde voorkoms (kanteling, ruis, optionele vuile achtergrond, optioneel A4).

Verzoek

Methode: POST
Content-Type: multipart/form-data (of application/x-www-form-urlencoded bij gebruik van alleen file_url kunt u application/x-www-form-urlencoded gebruiken)

Parameters

Parameter	Type	Vereist	Beschrijving
`file` of `pdf`	file	Nee	PDF-, JPG-, PNG-, TIFF- of WebP-bestand om te converteren (upload). Gebruik file of file_url.
`file_url`	string	Nee	HTTP(S) URL van 'n PDF of afbeelding om te converteren. Gebruik bestandsupload of file_url (max. 50 MB, 30 s time-out).
`color_mode`	string	Nee	color of bw. Standaard: bw (zwart-wit).
`rotate`	number	Nee	Pagina kanteling in graden (-1.5 tot 1.5). Standaard: 0.
`noise`	number	Nee	Hoeveelheid ruis 0–1. Standaard: 0.1 (10%).
`dirty_background`	string	Nee	1 (standaard) om vuile zwarte randen te tonen, 0 om uit te schakelen.
`force_a4`	string	Nee	1 (standaard) om uitvoer aan te passen aan A4, 0 om originele grootte te behouden.

Respons

Succes (200): Responsinhoud is het PDF-bestand. Bewaar of stream de binaire inhoud.

Fout (4xx/5xx): JSON-inhoud: {"ok": false, "error": "Foutmelding"}

Statuscodes

Code	Betekenis
200	Succes — respons is de PDF.
400	Slecht verzoek — ontbrekend bestand, verkeerd formaat of uploadfout.
401	Niet geautoriseerd — ontbrekende of ongeldige API-sleutel.
405	Methode niet toegestaan — gebruik POST.
500	Serverfout — conversie mislukt.
503	Service niet beschikbaar — conversie niet beschikbaar op server.

Voorbeelden

cURL

Een bestand uploaden:

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

Of 'n lêers-URL verzenden:

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

Verzoeken vanuit browsers zijn toegestaan vanuit elke oorsprong. Preflight OPTIONS-verzoeken worden ondersteund.

Gebruik en limieten

Elke conversie wordt geteld per API-sleutel. In uw dashboard kunt u het totale gebruik en gebruik over de laatste 7 en 30 dagen zien. Er zijn geen ingebouwde snelheidslimieten; server upload- en resourcelimieten kunnen van toepassing zijn.

Ondersteunde formaten

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

Uitvoer: Altijd PDF (met geskandeerde voorkoms).