← PDFtoSCAN Log ind / Få API-nøgle

API-dokumentation

Brug PDFtoSCAN-konvertering fra dine applikationer. Alle API-anmodninger kræver en API-nøgle (få en efter registrering).

Basis-URL

Alle endepunkter er relative til:

https://pdftoscan.com/api/v1

Autentificering

Inkluder din API-nøgle i hver anmodning ved hjælp af en af disse metoder:

Header Header X-API-Key: din-api-nøgle
Header Header Authorization: Bearer din-api-nøgle

For at få en API-nøgle: registrering, generer derefter en ny nøgle i din Dashboard. Nøglen vises kun én gang—opbevar den sikkert.

Konverter til scannet udseende

POST /convert.php

Upload en PDF eller billede, eller send en fil-URL, og modtag en PDF med scannet udseende (hældning, støj, valgfri snavset baggrund, valgfrit A4).

Anmodning

Metode: POST
Content-Type: multipart/form-data (eller application/x-www-form-urlencoded når du kun bruger file_url kan du bruge application/x-www-form-urlencoded)

Parametre

Parameter	Type	Påkrævet	Beskrivelse
`file` eller `pdf`	file	Nej	PDF-, JPG-, PNG-, TIFF- eller WebP-fil at konvertere (upload). Brug file eller file_url.
`file_url`	string	Nej	HTTP(S) URL for en PDF eller billede at konvertere. Brug filopload eller file_url (maks. 50 MB, 30 s timeout).
`color_mode`	string	Nej	color eller bw. Standard: bw (sort-hvid).
`rotate`	number	Nej	Sidehældning i grader (-1.5 til 1.5). Standard: 0.
`noise`	number	Nej	Støjmængde 0–1. Standard: 0.1 (10%).
`dirty_background`	string	Nej	1 (standard) for at vise snavsede sorte kanter, 0 for at deaktivere.
`force_a4`	string	Nej	1 (standard) for at tilpasse output til A4, 0 for at beholde originalstørrelse.

Respons

Succes (200): Responskroppen er PDF-filen. Gem eller stream det binære indhold.

Fejl (4xx/5xx): JSON-krop: {"ok": false, "error": "Fejlbesked"}

Statuskoder

Code	Betydning
200	Succes — responsen er PDF'en.
400	Dårlig anmodning — fil mangler, forkert format eller uploadfejl.
401	Uautoriseret — API-nøgle mangler eller ugyldig.
405	Metode ikke tilladt — brug POST.
500	Serverfejl — konvertering mislykkedes.
503	Service utilgængelig — konvertering ikke tilgængelig på server.

Eksempler

cURL

Upload 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 send 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

Anmodninger fra browsere er tilladt fra enhver oprindelse. Preflight OPTIONS-anmodninger understøttes.

Brug og grænser

Hver konvertering tælles pr. API-nøgle. I dit dashboard kan du se samlet brug og brug over de sidste 7 og 30 dage. Der er ingen indbyggede hastighedsgrænser; serverupload- og ressourcegrænser kan gælde.

Understøttede formater

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

Output: Altid PDF (med scannet udseende).