مقالات شائعة
عام
مقالات عامة عن أساسيات الواجهة البرمجية لزيتون وطرق الاتصال بها بمختلف لغات البرمجة
الاتصال بالواجهة البرمجية
نشرح في هذا المقال طريقة الاتصال بالواجهة البرمجية لزيتون، والخطوات اللازمة للحصول على مفتاح الواجهة API Key وطريقة استخدامه بالشكل الصحيح. متطلبات الاتصال يتطلب الاتصال بالواجهة البرمجية لزيتون الأمور التالية: حساب وكيل نحتاج لحساب وكيل agent مسجّل في مركز المساعدة، ويملك صلاحية الوصول للبيانات المطلوبة كالإعدادات، وجهات الاتصال، والدردشة المباشرة، وقاعدة المعرفة. وتجدر الإشارة إلى أن وكيل مركز...
الاستيثاق Authentication
نشرح في هذا المقال طريقة تنفيذ الاستيثاق في الواجهة البرمجية لزيتون، وطريقة تسجيل دخول وخروج الوكلاء للواجهة مع أمثلة توضيحية. تسجيل الدخول تستخدم نقطة الوصول Login لتسجيل الدخول للواجهة البرمجية والتحقق من هوية الوكيل المتصل، ومنحه صلاحية الوصول للبيانات والوظائف المناسبة في مركز المساعدة. علينا تمرير البريد الإلكتروني وكلمة المرور الخاصة بالوكيل ضمن جسم الطلب، وسنحصل في الاستجابة على معلومات حو...
رموز الاستجابة
قد نحصل على استجابات HTTP مختلفة عند التعامل مع الواجهة البرمجية لزيتون، وسنستعرض في هذا المقال أهم رموز الاستجابة ودلالتها. رموز النجاح 2xx تشير الرموز 2xx إلى قبول الطلب الذي أرسلت الوكيل ومعالجته بنجاح، على سبيل المثال يدل الرمز 200 على نجاح طلبات GET، والرمز 201 على نجاح طلبات POST. رموز أخطاء جانب العميل 4xx تشير الرموز 4xx إلى وجود خطأ في الطلب المرسل من قبل العميل، وقد يقع نتيجة عدة أسباب...
طلب GET
نوضح في هذا المقال ما هي طلبات GET، وكيفية إرسال هذه الطلبات لواجهة زيتون البرمجية من خلال عدة أمثلة عملية بمختلف لغات البرمجة. ما هو طلب GET تسمح طلبات GET المرسلة للواجهة البرمجية بجلب البيانات من الخادم دون تعديلها، عند إرسال هذا الطلب للواجهة البرمجية نحتاج لتضمين عنوان URL لنقطة الوصول المطلوبة، ونرسل المعاملات المطلوبة ضمن عنوان URL لتحديد البيانات المراد الحصول عليها. طلب GET لعرض صناديق ا...
طلب POST
نوضح في هذا المقال ما هي طلبات POST، وكيفية إرسال هذه الطلبات لواجهة زيتون البرمجية من خلال عدة أمثلة عملية بمختلف لغات البرمجة. ما هو طلب POST تسمح طلبات POST المرسلة للواجهة البرمجية بإنشاء أو تعديل البيانات على الخادم، بدلاً من مجرد استرجاعها كما في طلب GET ، عند إرسال الطلب للواجهة البرمجية نحتاج لتضمين عنوان URL لنقطة الوصول المطلوبة، وإرسال البيانات عبر جسم الطلب. طلب POST لإنشاء فريق جديد...