← PDFtoSCAN Skrá inn / Fá API lykil

API Skjölun

Notaðu PDFtoSCAN umbreytingu frá forritum þínum. Allar API beiðnir krefjast API lykils (fáðu eftir skráningu).

Grunn-URL

Allir endapunktar eru hlutfallslegir við:

https://pdftoscan.com/api/v1

Auðkenning

Láttu API lykilinn þinn fylgja með í hverri beiðni með því að nota eina af þessum aðferðum:

Header Haus X-API-Key: þinn-api-lykill
Header Haus Authorization: Bearer þinn-api-lykill

Til að fá API lykil: skráningu, búðu síðan til nýjan lykil í Stjórnborð þínu. Lykillinn er aðeins sýndur einu sinni—geymdu hann örugglega.

Umbreyta í skannað útlit

POST /convert.php

Hladdu upp PDF eða mynd, eða sendu skráar-URL, og fáðu PDF með skönnuðu útliti (halli, hávaði, valfrjálst óhreint bakgrunn, valfrjálst A4).

Beiðni

Aðferð: POST
Content-Type: multipart/form-data (eða application/x-www-form-urlencoded þegar þú notar aðeins file_url geturðu notað application/x-www-form-urlencoded)

Breytur

Breyta	Tegund	Nauðsynlegt	Lýsing
`file` eða `pdf`	file	Nei	PDF, JPG, PNG, TIFF eða WebP skrá til að umbreyta (upphleðsla). Notaðu file eða file_url.
`file_url`	string	Nei	HTTP(S) URL af PDF eða mynd til að umbreyta. Notaðu skráarupphleðslu eða file_url (hámark 50 MB, 30 s tímamörk).
`color_mode`	string	Nei	color eða bw. Sjálfgefið: bw (svart-hvítt).
`rotate`	number	Nei	Síðuhalli í gráðum (-1.5 til 1.5). Sjálfgefið: 0.
`noise`	number	Nei	Hávaðamagn 0–1. Sjálfgefið: 0.1 (10%).
`dirty_background`	string	Nei	1 (sjálfgefið) til að sýna óhreina svarta kanta, 0 til að slökkva.
`force_a4`	string	Nei	1 (sjálfgefið) til að laga úttak við A4, 0 til að halda upprunalegri stærð.

Svar

Árangur (200): Svarmeginmál er PDF skráin. Vistaðu eða streymaðu tvíundainnihaldið.

Villa (4xx/5xx): JSON meginmál: {"ok": false, "error": "Villuskilaboð"}

Stöðukóðar

Code	Merking
200	Árangur — svarið er PDF.
400	Slæm beiðni — skrá vantar, rangt snið eða upphleðsluvilla.
401	Óheimilt — API lykill vantar eða ógildur.
405	Aðferð ekki leyfð — notaðu POST.
500	Þjónsvilla — umbreyting mistókst.
503	Þjónusta ekki tiltæk — umbreyting ekki tiltæk á þjóni.

Dæmi

cURL

Hlaða upp skrá:

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

Eða senda skráar-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

Beiðnir frá vöfrum eru leyfðar frá hvaða uppruna sem er. Preflight OPTIONS beiðnir eru studdar.

Notkun og takmarkanir

Hver umbreyting er talin á API lykil. Á stjórnborðinu þínu geturðu séð heildarnotkun og notkun síðustu 7 og 30 daga. Engar innbyggðar hraðatakmarkanir; upphleðslu- og auðlindatakmarkanir þjóns geta átt við.

Studd snið

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

Úttak: Alltaf PDF (með skönnuðu útliti).