يدعم جهاز الكتابة الآلي iAuto تكامل API، مما يتيح للمطورين إرسال الأوامر والتحكم في الجهاز برمجيًا. يوضح هذا الدليل كيفية إجراء استدعاء API أساسي باستخدام أداة سطر الأوامر لبدء مهمة كتابة باستخدام ملف SVG. نزّل البرنامج مع مستند API هنا>>>
الخطوة 1: تحديد عنوان API
تأكد من اتصال الجهاز بشبكتك المحلية وحدد عنوان IP والمنفذ الخاصين به. على سبيل المثال: http://192.168.1.XXX:90
استبدل XXX بجزء عنوان IP المحلي الصحيح لإعدادك.
الخطوة 2: التعرّف على معلمات API
قبل إرسال الأوامر، تعرّف على المعلمات المطلوبة بواسطة API. يوضح هذا المثال كتابة ملف SVG واحد. وتتضمن هذه المعلمات ما يلي:
- file: مسار ملف SVG المراد كتابته
- width: عرض اللوحة (مثلًا، 210mm)
- height: ارتفاع اللوحة (مثلًا، 297mm)
- xpos: موضع البداية على المحور X
- ypos: موضع البداية على المحور Y
- scale: معامل التحجيم (القيمة الافتراضية هي 1)
- rotation: زاوية الدوران بالدرجات (القيمة الافتراضية هي 0)
- clear: يحدد ما إذا كان ينبغي مسح المهمة السابقة (اضبطه على 1 للمسح)
- start: يحدد ما إذا كان ينبغي بدء المهمة فورًا (اضبطه على 1 لبدء الكتابة)
اطّلع على الشفرة المصدرية للحصول على أوصاف تفصيلية وأنواع الأخطاء
إليك مثالًا على أمر يرسل ملف SVG إلى الجهاز للكتابة الفورية:
curl -X POST ^
-F "file=@\"F:\Desktop\concepts\tony.svg\"" ^
-F "width=210mm" ^
-F "height=297mm" ^
-F "xpos=100mm" ^
-F "ypos=100mm" ^
-F "scale=1" ^
-F "rotation=0" ^
-F "clear=1" ^
-F "start=1" ^
http://192.168.1.XXX:90/write_svg
⚠️ تأكد من صحة مسار الملف المحدد وعنوان API.
الخطوة 3: استدعاء API
إذا نجح الطلب، فسيحمّل الجهاز ملف SVG ويبدأ الكتابة فورًا.
معاينة الواجهة
في حال حدوث خطأ، راجع الملف المصدر لمعرفة سبب الخطأ.
بعد إدخال الأمر، ستكون واجهة الجهاز كما يلي. سيستورد الجهاز صورة SVG تلقائيًا ويبدأ الكتابة تلقائيًا.
مثال على المخرجات
ملاحظات إضافية
- يمكنك أيضًا استخدام API بالتزامن مع لغات برمجة أخرى، مثل Python، لتنفيذ عمليات سير عمل أكثر تقدمًا أو مهام مؤتمتة.
- مهم: تكامل API مخصص للمطورين أو الفنيين. رغم أننا نوفر واجهات API وشفرة المصدر للرجوع إليها، لا توفر UUNA TEK دعمًا فنيًا لاستخدام API المخصص. يتم توفير منافذ API فقط.