← 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 ميجابايت، مهلة 30 ثانية).
`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 للفحص المسبق مدعومة.

الاستخدام والحدود

يتم حساب كل تحويل لكل مفتاح API. في لوحة التحكم يمكنك رؤية إجمالي الاستخدام والاستخدام خلال آخر 7 و 30 يومًا. لا توجد حدود معدل مدمجة؛ قد تنطبق حدود تحميل الخادم والموارد.

التنسيقات المدعومة

الإدخال: PDF، JPG، JPEG، PNG، TIFF، WebP.

الإخراج: دائمًا PDF (بمظهر مسح ضوئي).