تخطي إلى المحتوى الرئيسي

اعثر على أداتك التالية

لوحة التحكمتطبيق Android
اللغة
المظهر
واجهة API للمطورين والأتمتة

ابنِ أتمتة المستندات فوق MAXScanner

واجهة REST لتحويل المستندات ودمجها وOCR، مع دعم كامل لـ Zapier وMake وn8n. ابدأ مجانًا دون بطاقة ائتمان.

البدء السريع

  1. سجّل الدخول وافتح لوحة التحكم، ثم انتقل إلى API والأتمتة ← مفاتيح API ← إنشاء مفتاح جديد.
  2. انسخ المفتاح (يُعرض مرة واحدة فقط)، ويبدو هكذا: mxs_xxxxxxxx_xxxxxxxxxxxx.
  3. أرسله كرمز Bearer مع كل طلب: Authorization: Bearer YOUR_API_KEY.
curl -X POST https://maxscanner.app/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/report.docx","filename":"report.docx","format":"pdf"}' \
  --output report.pdf
مباشر

جرّب API الآن

يستدعي هذا نقطة النهاية الحقيقية /api/v1/sandbox/convert ويحوّل مستندًا تجريبيًا صغيرًا يُنشأ فورًا. لا حاجة إلى مفتاح API، ولا يعمل إلا من هذه الصفحة على maxscanner.app، لذا لا يمكن تضمينه أو استغلاله في مكان آخر.

حدود الاستخدام والأرصدة المجانية

الخطة المجانية

10 / يوم

و100 طلب شهريًا، مجانًا إلى الأبد. لا حاجة إلى بطاقة ائتمان.

الخطط المدفوعة

2000 – غير محدود

Starter (2000 رصيد/شهر)، وPro (10000/شهر)، وBusiness (غير محدود).

تستهلك الخطط المدفوعة أرصدة لكل عملية:

التحويل — 2 رصيدالدمج — 1 رصيدOCR — 3 أرصدةفحص الاستخدام — مجاني

نقاط النهاية

عنوان URL الأساسي: https://maxscanner.app/api/v1

GET/healthمجاني، دون مفتاح

يتحقق من أن API تعمل، وهو مفيد لخطوة «اختبار الاتصال» في Zapier.

الاستجابة

{ "status": "ok", "service": "MAXScanner Public API", "version": "v1" }
GET/usageمجاني

اعرض خطتك الحالية والحصة المتبقية للمفتاح الذي ترسله.

الاستجابة

{ "plan": "Free", "limits": { "per_day": 10, "per_month": 100 },
  "remaining": { "today": 7, "this_month": 84 } }
POST/convert2 رصيد

يحوّل مستندًا من عنوان URL إلى صيغة أخرى (pdf وdocx وxlsx وpptx وtxt وhtml وpng وغيرها).

نص الطلب

{ "url": "https://example.com/report.docx",
  "filename": "report.docx", "format": "pdf" }

الاستجابة

ملف ثنائي (يطابق Content-Type الصيغة المطلوبة)
POST/merge1 رصيد

يدمج من 2 إلى 20 ملف PDF (مقدَّمة كعناوين URL) في ملف PDF واحد بالترتيب المحدد.

نص الطلب

{ "files": ["https://.../page1.pdf", "https://.../page2.pdf"] }

الاستجابة

ملف ثنائي (application/pdf)
POST/ocr3 أرصدة

يستخرج النص من صورة أو ملف PDF ممسوح ضوئيًا عبر OCR حقيقي، حتى دون أي طبقة نصية.

نص الطلب

{ "url": "https://.../scan.pdf", "filename": "scan.pdf", "language": "eng" }

الاستجابة

{ "text": "...", "pages": 3, "language": "eng" }
POST/documents/import1 رصيد

يضيف ملفًا إلى مكتبة MAXScanner من الأتمتة، وهو الاتجاه المعاكس لـ /convert.

نص الطلب

{ "url": "https://.../invoice.pdf", "filename": "invoice.pdf" }

الاستجابة

{ "id": "...", "filename": "invoice.pdf", "downloadUrl": "..." }
POST/hooks/subscribeمجاني

يسجّل عنوان URL لخطاف ويب لتلقي الأحداث المستقبلية من نوع واحد. راجع «خطافات الويب وZapier وn8n» أدناه.

نص الطلب

{ "event": "scan.created", "targetUrl": "https://hooks.zapier.com/..." }

الاستجابة

{ "id": "...", "event": "scan.created", "targetUrl": "..." }
POST/hooks/unsubscribeمجاني

يزيل اشتراك خطاف ويب حسب المعرّف id.

نص الطلب

{ "id": "..." }

الاستجابة

{ "success": true }
GET/hooksمجاني

يعرض اشتراكات خطافات الويب النشطة مع حالة آخر تسليم لكل منها.

الاستجابة

{ "subscriptions": [{ "id": "...", "event": "scan.created", "targetUrl": "..." }] }

يدعم /convert (ليس صيغ Office فقط)

Word / Excel / PowerPointPDFالتحويل الكلاسيكي «Office إلى PDF»
PDFWord / نص عادي / HTML«PDF إلى Office»
PDFصورة PNG / JPGصورة واحدة لكل صفحة
صورة PNG / JPGPDFتحويل صورة إلى صفحة PDF

Zapier وMake وn8n وخطافات الويب

اربط تطبيق MAXScanner لنظام Android بأكثر من 5000 تطبيق. في التطبيق، افتح الإعدادات ← Zapier والأتمتة (أو بطاقة API والأتمتة في الأدوات) للاشتراك والحصول على مفتاح التكامل، ثم استخدمه كمفتاح MAXScanner API في خطوة الاتصال في Zapier. يعمل المفتاح نفسه أيضًا مع استدعاءات REST المباشرة أعلاه.

المشغّلات المتاحة

مستند ممسوح جديدscan.createdجميع الخطط

يُشغَّل كلما تم مسح مستند جديد في التطبيق.

تصدير PDF جديدpdf.exportedجميع الخطط

يُشغَّل عند تصدير مجموعة مستندات إلى PDF.

مسح جديد بموقع جغرافيgeotag.capturedPro وما فوق

يُشغَّل لعمليات المسح الموسومة ببيانات الموقع (العنوان والمدينة والإحداثيات).

التقاط جديد بطابع زمنيtimestamp.capturedBusiness

يُشغَّل لعمليات الالتقاط التي تحمل طابعًا زمنيًا.

نص OCR جديد مستخرجocr.completedPro وما فوق

يُشغَّل عندما يتوفر نص OCR على الجهاز لعملية مسح.

رمز QR جديد ممسوحqr.scannedجميع الخطط

يُشغَّل لحظة مسح رمز QR في التطبيق، مع النص بعد فك ترميزه.

Make.com

سيناريوهات أتمتة مرئية

n8n

أتمتة مسارات عمل مستضافة ذاتيًا

خطافات الويب

استدعاءات HTTP مباشرة لكل ما عدا ذلك

تعمل المنصات الثلاث هنا بالطريقة نفسها: تمنحك عنوان URL، وتطلب من MAXScanner إرسال POST إليه عبر /hooks/subscribe. لا يوجد بعد تطبيق Zapier أصلي للتثبيت، بل يُستخدم إجراء Zapier العام Webhooks by Zapier الذي يعمل اليوم.

⚡ Zapier خطوة بخطوة

  1. أنشئ Zap ← ابحث عن تطبيق Webhooks by Zapier ← اختر حدث المشغّل Catch Hook.
  2. يعرض لك Zapier عنوان URL مخصصًا لخطاف الويب (مثل https://hooks.zapier.com/hooks/catch/...). انسخه.
  3. استدعِ /hooks/subscribe في MAXScanner مرة واحدة بهذا العنوان والحدث الذي تريده (راجع مثال curl أدناه).
  4. عُد إلى Zapier وشغّل حدثًا تجريبيًا من التطبيق (مثل مسح مستند)؛ يجب أن تعرض خطوة Catch Hook بيانات نموذجية. تابع بناء خطوة الإجراء في Zap من هناك (Google Drive أو Sheets أو Slack أو البريد الإلكتروني أو أي شيء آخر).

🔄 n8n خطوة بخطوة

  1. أضف عقدة مشغّل Webhook إلى مسار عمل جديد، واضبطها لقبول طلبات POST.
  2. انسخ Production URL للعقدة (فعّل مسار العمل أولًا ليكون قيد التشغيل).
  3. استدعِ /hooks/subscribe بهذا العنوان والحدث الذي اخترته.
  4. شغّل حدثًا تجريبيًا من التطبيق؛ تلتقط عقدة Webhook البيانات وتصبح جاهزة لربطها ببقية مسار العمل.

الاشتراك عبر curl

curl -X POST https://maxscanner.app/api/v1/hooks/subscribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"scan.created","targetUrl":"https://hooks.zapier.com/hooks/catch/.../..."}'

هل أنت مستعد لأتمتة مستنداتك؟

أنشئ مفتاح API مجانيًا: 10 طلبات يوميًا و100 طلب شهريًا، دون بطاقة.