Make (Integromat): سيناريوهات مع MaxScanner
استخدم وحدتي HTTP وWebhooks في Make لتحويل الملفات وضغطها وتطبيق OCR عليها باستخدام MaxScanner داخل أي سيناريو.
إجابة مختصرة
في Make، أضف وحدة HTTP "Make a request" واضبط الطريقة على POST والعنوان على https://maxscanner.app/api/v1/jobs/ مع ترويسة Authorization: Bearer <key>، ونوع الجسم Raw ونوع المحتوى JSON. خزّن المفتاح في اتصال (connection) أو مخزن بيانات (data store) في Make، لا في حقول وحدات مكشوفة كنص عادي يطّلع عليها آخرون. ولمعرفة اكتمال المهام، أنشئ سيناريو يبدأ بوحدة Webhooks "Custom webhook" واشترك بعنوان URL الخاص به في processing.completed.
البدء السريع
- 1أنشئ مفتاح API في MaxScanner باسم "Make".
- 2أضف HTTP → Make a request: POST https://maxscanner.app/api/v1/jobs/ مع الترويستين Authorization وIdempotency-Key، وجسم JSON يتضمن url وfilename وformat. وفعّل "Parse response".
- 3أنشئ سيناريو منفصلًا يبدأ بـ Webhooks → Custom webhook وانسخ عنوان خطاف الويب.
- 4اشترك بالعنوان مرة واحدة باستخدام POST /api/v1/hooks/subscribe/ (الحدث processing.completed).
- 5في سيناريو خطاف الويب، أضف HTTP → Make a request: GET {{data.statusUrl}} مع ترويسة Authorization، ثم مرّر output.downloadUrl إلى الوحدة التالية.
جسم الطلب
اربط Idempotency-Key بقيمة فريدة لكل عنصر، مثل معرّف السجل في الحزمة (bundle)، حتى لا تؤدي إعادة تشغيل سيناريو فاشل إلى إنشاء مهام مكررة.
{
"url": "{{1.attachment.url}}",
"filename": "{{1.attachment.name}}",
"format": "pdf"
}الاستعلام الدوري داخل سيناريو واحد
إذا لم يكن خطاف الويب خيارًا متاحًا، فأضف وحدة Sleep (5–10 ثوانٍ) ووحدة Repeater مع موجّه (router) يتوقف عندما تكون قيمة status هي completed أو failed. يستهلك هذا عمليات وطلبات MaxScanner أكثر من نمط خطاف الويب، لذا احتفظ به للأحجام المنخفضة.
معالجة الأخطاء
أرفق معالج أخطاء بوحدة HTTP: استخدم Break مع إعادة المحاولة التلقائية لاستجابات 429 و5xx، واستخدم Ignore أو Rollback لاستجابات 4xx التي تحتاج إلى إصلاح. ويعرض Make رمز خطأ MaxScanner في مخرجات الوحدة.
الأسئلة الشائعة
هل يمكنني إرسال الملف بصيغة ثنائية بدلًا من URL؟
نعم: استدعِ /extension/upload/ للحصول على رابط URL موقّع، وارفع البيانات الثنائية بطلب PUT عبر وحدة HTTP ثانية، ثم استخدم قيمة objectKey المُرجعة بوصفها sourceKey.