← PDFtoSCAN Logga in / Få API-nyckel

API-dokumentation

Använd PDFtoSCAN-konvertering från dina applikationer. Alla API-förfrågningar kräver en API-nyckel (få en efter registrering).

Bas-URL

Alla ändpunkter är relativa till:

https://pdftoscan.com/api/v1

Autentisering

Inkludera din API-nyckel i varje förfrågan med en av dessa metoder:

Header Header X-API-Key: din-api-nyckel
Header Header Authorization: Bearer din-api-nyckel

För att få en API-nyckel: registrering, generera sedan en ny nyckel i din Instrumentpanel. Nyckeln visas bara en gång—förvara den säkert.

Konvertera till skannat utseende

POST /convert.php

Ladda upp en PDF eller bild, eller skicka en fil-URL, och få en PDF med skannat utseende (lutning, brus, valfri smutsig bakgrund, valfritt A4).

Förfrågan

Metod: POST
Content-Type: multipart/form-data (eller application/x-www-form-urlencoded när du endast använder file_url kan du använda application/x-www-form-urlencoded)

Parametrar

Parameter	Typ	Krävs	Beskrivning
`file` eller `pdf`	file	Nej	PDF-, JPG-, PNG-, TIFF- eller WebP-fil att konvertera (uppladdning). Använd file eller file_url.
`file_url`	string	Nej	HTTP(S) URL för en PDF eller bild att konvertera. Använd filuppladdning eller file_url (max. 50 MB, 30 s timeout).
`color_mode`	string	Nej	color eller bw. Standard: bw (svartvit).
`rotate`	number	Nej	Sidlutning i grader (-1.5 till 1.5). Standard: 0.
`noise`	number	Nej	Brusmängd 0–1. Standard: 0.1 (10%).
`dirty_background`	string	Nej	1 (standard) för att visa smutsiga svarta kanter, 0 för att inaktivera.
`force_a4`	string	Nej	1 (standard) för att anpassa utdata till A4, 0 för att behålla originalstorlek.

Svar

Framgång (200): Svarskroppen är PDF-filen. Spara eller strömma det binära innehållet.

Fel (4xx/5xx): JSON-kropp: {"ok": false, "error": "Felmeddelande"}

Statuskoder

Code	Betydelse
200	Framgång — svaret är PDF:en.
400	Dålig förfrågan — fil saknas, fel format eller uppladdningsfel.
401	Obehörig — API-nyckel saknas eller ogiltig.
405	Metod ej tillåten — använd POST.
500	Serverfel — konvertering misslyckades.
503	Tjänst otillgänglig — konvertering ej tillgänglig på server.

Exempel

cURL

Ladda upp en fil:

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

Eller skicka en fil-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

Förfrågningar från webbläsare är tillåtna från vilket ursprung som helst. Preflight OPTIONS-förfrågningar stöds.

Användning och gränser

Varje konvertering räknas per API-nyckel. I din instrumentpanel kan du se total användning och användning under de senaste 7 och 30 dagarna. Det finns inga inbyggda hastighetsgränser; serverns uppladdnings- och resursgränser kan gälla.

Format som stöds

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

Utdata: Alltid PDF (med skannat utseende).