← 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	خیر	URL HTTP(S) یک 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 (با ظاهر اسکن شده).