← 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	Όχι	HTTP(S) URL ενός PDF ή εικόνας για μετατροπή. Χρησιμοποιήστε ανέβασμα αρχείου ή 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

Οι αιτήσεις από προγράμματα περιήγησης επιτρέπονται από οποιαδήποτε προέλευση. Υποστηρίζονται αιτήσεις OPTIONS preflight.

Χρήση και όρια

Κάθε μετατροπή μετράται ανά κλειδί API. Στον πίνακα ελέγχου σας μπορείτε να δείτε τη συνολική χρήση και τη χρήση τις τελευταίες 7 και 30 ημέρες. Δεν υπάρχουν ενσωματωμένα όρια ταχύτητας· μπορεί να ισχύουν όρια ανεβάσματος και πόρων διακομιστή.

Υποστηριζόμενες μορφές

Είσοδος: PDF, JPG, JPEG, PNG, TIFF, WebP.

Έξοδος: Πάντα PDF (με σαρωμένη εμφάνιση).