← PDFtoSCAN Logg inn / Få API-nøkkel

API-dokumentasjon

Bruk PDFtoSCAN-konvertering fra applikasjonene dine. Alle API-forespørsler krever en API-nøkkel (få en etter registrering).

Basis-URL

Alle endepunkter er relative til:

https://pdftoscan.com/api/v1

Autentisering

Inkluder API-nøkkelen din i hver forespørsel ved å bruke en av disse metodene:

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

For å få en API-nøkkel: registrering, generer deretter en ny nøkkel i Dashbord. Nøkkelen vises bare én gang—oppbevar den trygt.

Konverter til skannet utseende

POST /convert.php

Last opp en PDF eller bilde, eller send en fil-URL, og motta en PDF med skannet utseende (helning, støy, valgfri skitten bakgrunn, valgfritt A4).

Forespørsel

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

Parametere

Parameter	Type	Påkrevd	Beskrivelse
`file` eller `pdf`	file	Nei	PDF-, JPG-, PNG-, TIFF- eller WebP-fil å konvertere (opplasting). Bruk file eller file_url.
`file_url`	string	Nei	HTTP(S) URL for en PDF eller bilde å konvertere. Bruk filopplasting eller file_url (maks. 50 MB, 30 s timeout).
`color_mode`	string	Nei	color eller bw. Standard: bw (svart-hvitt).
`rotate`	number	Nei	Sidehelning i grader (-1.5 til 1.5). Standard: 0.
`noise`	number	Nei	Støymengde 0–1. Standard: 0.1 (10%).
`dirty_background`	string	Nei	1 (standard) for å vise skitne svarte kanter, 0 for å deaktivere.
`force_a4`	string	Nei	1 (standard) for å tilpasse utdata til A4, 0 for å beholde originalstørrelse.

Respons

Suksess (200): Responskroppen er PDF-filen. Lagre eller strøm det binære innholdet.

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

Statuskoder

Code	Betydning
200	Suksess — responsen er PDF-en.
400	Dårlig forespørsel — fil mangler, feil format eller opplastingsfeil.
401	Uautorisert — API-nøkkel mangler eller ugyldig.
405	Metode ikke tillatt — bruk POST.
500	Serverfeil — konvertering mislyktes.
503	Tjeneste utilgjengelig — konvertering ikke tilgjengelig på server.

Eksempler

cURL

Last opp 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

Forespørsler fra nettlesere er tillatt fra hvilken som helst opprinnelse. Preflight OPTIONS-forespørsler støttes.

Bruk og grenser

Hver konvertering telles per API-nøkkel. I dashbordet ditt kan du se total bruk og bruk over de siste 7 og 30 dagene. Det er ingen innebygde hastighetsgrenser; serveropplastings- og ressursgrenser kan gjelde.

Støttede formater

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

Utdata: Alltid PDF (med skannet utseende).