المحتوى العام

تتناول صفحة «المحتوى العام — مرجع واجهة برمجة التطبيقات» مجال الوظيفة المحدد في هذا الرابط. ويُستكمل الملخص الحالي بسير العمل الفعلي والمتطلبات والقيود المعروفة. لا تملك Zentor نظام مفاتيح API للمطورين. تستخدم لوحة التحكم Session JWT لمدة 12 ساعة وRefresh Token لمدة سبعة أيام، مع TOTP وSSO اختياريين. يُعرض Widget Embed Token كنص واضح مرة واحدة فقط ويُقيد بالمصادر المسموح بها.

يمثل المسار `GET /api/public/legal` العملية المحددة في هذه مادة المساعدة. من الضروري أن على العميل الالتزام بطريقة HTTP والمسار ونوع المصادقة والحقول الإلزامية وحالات الخطأ الموثقة. لا توفر Zentor نظام مفتاح API عام للمطورين؛ فالمسار إما عام أو محمي برمز تضمين Widget والتحقق من المصدر. عند استدعاء `/api/public/legal` يلزم تقييم حالة HTTP مع محتوى JSON معًا. أخطاء المراجعة أو المورد غير الموجود أو المصدر المرفوض أو القيمة المنتهية أو خطأ الخادم حالات مختلفة. نجاح الطلب يثبت معالجة هذه الخطوة فقط، ولا يثبت تلقائيًا وصول بريد أو اكتمال دفع أو انتهاء تسجيل SSO. يجب اختبار `GET /api/public/legal` بقيم مجهولة الهوية. لا تُنشر بيانات عميل حقيقية أو UUID شبيهة بالإنتاج أو JWT أو رموز Widget أو طوابع زمنية حقيقية. الحد المعروف للمنصة هو 2000 طلب خلال 15 دقيقة، ولم يُنفذ حد منفصل مثبت لهذا المسار. لا ينبغي تكرار طلب POST غير المتطابق القوة تلقائيًا بمجرد انقطاع شبكة غير واضح، لأن الطلب الأول ربما أحدث أثرًا. يمكن تسجيل الحالة ورمز خطأ آمن، لكن لا تُسجل كلمات المرور أو رموز التحقق أو رموز إعادة التعيين. بالنسبة إلى «المحتوى العام — مرجع واجهة برمجة التطبيقات»، مصدر الحقيقة هو سجل API والمسار الخلفي والاختبارات. الاختبار السلبي أو التشابه مع مسار آخر لا يمثل تحققًا حيًا كاملًا. يلزم الفصل بين المعلومات المستخرجة من المخطط والاختبار الآلي والملاحظة الحية الآمنة. عند تنفيذ `GET /api/public/legal` يجب تقييم حالة HTTP ورمز الخطأ المنظم ومرجع داخلي آمن معًا. يساعد ذلك على التمييز بين خطأ الإدخال ومشكلة المصادقة أو التحقق من المصدر أو المعالجة على الخادم. يجب أن تبقى الأمثلة العامة مجهولة الهوية، وألا تتضمن كلمات مرور أو رموز وصول أو معرفات عملاء حقيقية أو طوابع زمنية إنتاجية في التوثيق أو رسائل الدعم.