How to Use the API for the iAuto Automatic Writing Machine: A Simple Example

كيفية استخدام واجهة برمجة التطبيقات لجهاز iAuto للكتابة التلقائية: مثال بسيط

تدعم آلة الكتابة التلقائية iAuto تكامل API، مما يمكّن المطورين من إرسال الأوامر والتحكم في الجهاز برمجيًا. يوضح هذا الدليل كيفية إجراء استدعاء API أساسي باستخدام أداة سطر الأوامر لبدء مهمة كتابة باستخدام ملف SVG. حمّل البرنامج مع وثائق API من هنا>>>

الخطوة 1: تحديد عنوان API

تحديد عنوان API

تأكد من اتصال الجهاز بشبكتك المحلية وحدد عنوان IP والمنفذ الخاص به. على سبيل المثال: http://192.168.1.XXX:90

استبدل XXX بقطاع عنوان IP المحلي الصحيح لإعدادك.

تحديد عنوان API

الخطوة 2: فهم معلمات API

فهم معلمات API

قبل إرسال الأوامر، تعرّف على المعلمات المطلوبة من API. يوضح هذا المثال كيفية كتابة ملف SVG واحد. تشمل هذه المعلمات:

  • file: مسار ملف SVG المراد كتابته
  • width: عرض اللوحة (مثلاً 210مم)
  • height: ارتفاع اللوحة (مثلاً 297مم)
  • xpos: موضع البداية على المحور X
  • ypos: موضع البداية على المحور Y
  • scale: عامل التكبير/التصغير (الافتراضي 1)
  • rotation: زاوية الدوران بالدرجات (الافتراضي 0)
  • clear: هل تمسح المهمة السابقة (اضبط على 1 للمسح)
  • start: هل تبدأ المهمة فورًا (اضبط على 1 للبدء في الكتابة)

اطلع على كود المصدر للوصف التفصيلي وأنواع الأخطاء

نفذ استدعاء API

إليك مثال على أمر يرسل ملف 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 فقط.

 

 

Back to blog

Leave a comment

Please note, comments need to be approved before they are published.