← 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 (სკანირებული სახით).