الأسئلة الشائعة

أين أجد توثيق الواجهة البرمجية؟

تقدّم الواجهة البرمجية عقد OpenAPI على /v1/openapi.yaml وواجهة Swagger على /v1/docs (الإنتاج: https://api.roundworld.sy/v1/docs). وثائق المنتج على https://docs.roundworld.sy.

كيف أرى ما صُدر مؤخراً؟

افتح سجل التغييرات. يُنسَّق من تاريخ فرع main (ملاحظات منتج مؤرَّخة، وليس سجلاً خاماً للالتزامات).

كيف أتواصل مع الدعم من التطبيق؟

افتح مركز المساعدة في لوحة الإدارة، ابحث في الوثائق، ثم أرسل نموذج التواصل. ينشئ النموذج تذكرة دعم مستضافة ذاتياً عبر /v1/support/tickets.

كيف تعمل حدود المعدل؟

الطلبات المصادق عليها تُحدّ حسب المستخدم، وغير المصادق عليها حسب IP، والحدود حسب الطريقة والمسار. راجع حدود المعدل وعدم التكرار.

هل يمكن لأمناء الصندوق العمل دون اتصال؟

نعم. نقاط البيع على الجوال وWindows تُصفّ المبيعات في صندوق صادر محلي وتُزامن عند عودة الاتصال. راجع المزامنة دون اتصال ونقاط البيع وأمين الصندوق.

ماذا يفعل مسار حذف البيانات؟

POST /v1/me/data-delete ينشئ طلب مراجعة للحذف. يجب على تدبير الاحتفاظ بالسجلات المطلوبة قانوناً للمحاسبة أو الضرائب أو منع الاحتيال أو معالجة النزاعات.

أين يُنشر حالة النظام؟

صفحة الحالة المستضافة ذاتياً تُولَّد من موقع التسويق على /status؛ يمكن لمزودي وقت التشغيل الخارجيين نشر الحوادث أيضاً. Grafana للمشغّلين على https://grafana.roundworld.sy.