← PDFtoSCAN Մուտք / Ստանալ API բանալի

API Փաստաթղթավորում

Օգտագործեք PDFtoSCAN փոխարկումը ձեր հավելվածներից: Բոլոր API հարցումները պահանջում են API բանալի (գրանցում-ից հետո ստացեք):

Բազային URL

Բոլոր վերջնակետերը հարաբերական են:

https://pdftoscan.com/api/v1

Նույնականացում

Ներառեք ձեր API բանալին յուրաքանչյուր հարցումում՝ օգտագործելով այս մեթոդներից մեկը:

Header Վերնագիր X-API-Key: ձեր-api-բանալին
Header Վերնագիր Authorization: Bearer ձեր-api-բանալին

API բանալի ստանալու համար: գրանցում, ապա ձեր Վահանակ-ում ստեղծեք նոր բանալի: Բանալին ցուցադրվում է միայն մեկ անգամ—պահեք այն անվտանգ:

Փոխարկել սկանավորված տեսքի

POST /convert.php

Վերբեռնեք PDF կամ նկար, կամ ուղարկեք ֆայլի URL և ստացեք սկանավորված տեսքով PDF (թեքում, աղմուկ, ըստ ցանկության կեղտոտ ֆոն, ըստ ցանկության A4):

Հարցում

Մեթոդ: POST
Content-Type: multipart/form-data (կամ application/x-www-form-urlencoded երբ օգտագործում եք միայն file_url, կարող եք օգտագործել application/x-www-form-urlencoded)

Պարամետրեր

Պարամետր	Տեսակ	Պահանջվում է	Նկարագրություն
`file` կամ `pdf`	file	Ոչ	Փոխարկելու համար PDF, JPG, PNG, TIFF կամ WebP ֆայլ (վերբեռնում): Օգտագործեք file կամ file_url:
`file_url`	string	Ոչ	Փոխարկելու համար PDF-ի կամ նկարի HTTP(S) URL: Օգտագործեք ֆայլի վերբեռնում կամ file_url (մաքս. 50 MB, 30 s ժամանակի սահմանափակում):
`color_mode`	string	Ոչ	color կամ bw: Լռելյայն: bw (սև-սպիտակ):
`rotate`	number	Ոչ	Էջի թեքումը աստիճաններով (-1.5-ից 1.5): Լռելյայն: 0:
`noise`	number	Ոչ	Աղմուկի քանակը 0–1: Լռելյայն: 0.1 (10%):
`dirty_background`	string	Ոչ	1 (լռելյայն) կեղտոտ սև եզրերը ցուցադրելու համար, 0 անջատելու համար:
`force_a4`	string	Ոչ	1 (լռելյայն) ելքը A4-ին հարմարեցնելու համար, 0 բնօրինակ չափը պահպանելու համար:

Պատասխան

Հաջողություն (200): Պատասխանի մարմինը PDF ֆայլն է: Պահպանեք կամ հոսեցրեք երկուական բովանդակությունը:

Սխալ (4xx/5xx): JSON մարմին: {"ok": false, "error": "Սխալի հաղորդագրություն"}

Կարգավիճակի կոդեր

Code	Նշանակություն
200	Հաջողություն — պատասխանը PDF է:
400	Վատ հարցում — ֆայլը բացակայում է, սխալ ֆորմատ կամ վերբեռնման սխալ:
401	Չթույլատրված — API բանալին բացակայում է կամ անվավեր է:
405	Մեթոդին թույլատրված չէ — օգտագործեք POST:
500	Սերվերի սխալ — փոխարկումը ձախողվեց:
503	Ծառայությունը հասանելի չէ — փոխարկումը հասանելի չէ սերվերում:

Օրինակներ

cURL

Վերբեռնեք ֆայլ:

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

Կամ ուղարկեք ֆայլի 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

Բրաուզերներից հարցումներին թույլատրվում է ցանկացած ծագումից: Preflight OPTIONS հարցումները աջակցվում են:

Օգտագործում և սահմանափակումներ

Յուրաքանչյուր փոխարկում հաշվարկվում է API բանալու համար: Ձեր վահանակում կարող եք տեսնել ընդհանուր օգտագործումը և վերջին 7 և 30 օրերի օգտագործումը: Ներկառուցված արագության սահմանափակումներ չկան. կարող են կիրառվել սերվերի վերբեռնման և ռեսուրսների սահմանափակումներ:

Աջակցվող ֆորմատներ

Մուտք: PDF, JPG, JPEG, PNG, TIFF, WebP:

Ելք: Միշտ PDF (սկանավորված տեսքով):