واجهة REST API واحدة بتتحكم في قارئات وأجهزة إبطال تاجات الـ RFID — بدون أي تسجيل مسبق للأجهزة. كل عملية بتحدد عنوان الجهاز في الطلب نفسه، والنظام بيتصل وينفّذ ويخزّن النتائج تلقائياً.
ثلاث ركائز بيقوم عليها النظام:
كل طلب بيحمل عنوان الجهاز (IP + Port). السيرفر بيفتح الاتصال، ينفّذ الأمر، يرجّع النتيجة، ويقفل — تقدر تشغّل أي عدد من الأجهزة بدون أي إعداد مسبق.
كل جهاز عبارة عن Driver واحد بيعلن عن قدراته وأوامره وقواعد التحقق بتاعتها. إضافة جهاز جديد (طابعة، ماسح باركود...) لا تتطلب أي تعديل في الـ API نفسها.
كل الواجهات محمية بمفتاح API مع صلاحيات متدرّجة — مفتاح العرض يقرأ البيانات بس، وأمر إبطال التاج نهائياً محصور على مفتاح الإدارة وحده.
كل عملية قراءة بتتسجل في قاعدة البيانات: التاجات (EPC/TID)، قوة الإشارة، الجلسات، وسجلات الـ TID — مع واجهات بحث وفلترة جاهزة للتقارير والجرد.
مقروءة مباشرة من كتالوج النظام (2 جهاز):
النوع ur4 ·
الفئة rfid-reader ·
الاتصال tcp
3 أوامر: scan · stop · set-power
✔ أوامر تشغيل عادية
النوع jmq-decoder ·
الفئة rfid-decoder ·
الاتصال http-bridge
7 أوامر: read · set-power · read-memory · write-memory · write-epc · kill · lock
⚠ يتضمن أمر إبطال نهائي — يحتاج مفتاح إدارةأهم الواجهات — كلها بتطلب مفتاح X-Api-Key. التفاصيل الكاملة بأمثلة حقيقية في التوثيق:
/api/v1/devices اكتشاف الأجهزة المدعومة وقدراتها/api/v1/devices/{type}/test اختبار الاتصال بجهاز/api/v1/devices/ur4/actions/scan مسح التاجات وتخزين النتائج/api/v1/devices/jmq-decoder/actions/kill إبطال تاج نهائياً/api/v1/rfid/tags استعلام عن التاجات المقروءة/api/v1/rfid/sessions جلسات المسح وتفاصيلهاهذا النظام مُصمَّم ومُنفَّذ بواسطة فريق شركة CrocoIT لحلول البرمجيات. لو واجهتكم أي مشكلة أو محتاجين دعم فني أو تطوير إضافي — يسعدنا تواصلكم معنا في أي وقت.