قبل البدء في استخدام الواجهة البرمجية، عليك المصادقة لإنشاء جلسة.
المصادقه:
توجد طريقتان لبدء الجلسة:
- استخدام مفتاح الواجهة البرمجية وتفاصيل تسجيل الدخول وكلمة المرور؛
- استخدام مفتاح الواجهة البرمجية وتفاصيل تسجيل الدخول وكلمة المرور المشفّرة.
- مفتاح الواجهة البرمجية وتفاصيل تسجيل الدخول وكلمة المرور. قيمة المعلمة encryptionKey في نقطة نهاية POST / session = false
- هنا يجب عليك ببساطة استخدام نقطة نهاية POST / session وذكر المفتاح المستلم تحت عنوان X-CAP-API-KEY من اعدادات - مفتاح الواجهة البرمجية للمنصة، ومعلومات تسجيل الدخول وكلمة المرور في معلمات المعرّف وكلمة المرور.
مفتاح الواجهة البرمجية وتفاصيل تسجيل الدخول وكلمة المرور المشفّرة. قيمة المعلمة encryptionKey في نقطة نهاية POST / session = true
- يجب عليك أولًا استخدام GET / session / encryptionKey وذكر المفتاح المستلم تحت عنوان X-CAP-API-KEY من اعدادات مفتاح الواجهة البرمجية للمنصة. وستستلم معلمات مفتاح التشفير "encryptionKey" والطابع الزمني في الرد؛
- باستخدام معلمات مفتاح التشفير "encryptionKey" والطابع الزمني المستلمة، يجب عليك تشفير كلمة المرور الخاصة بك باستخدام طريقة تشفير AES.
- انتقل إلى نقطة نهاية POST / session، وقم بتعيين القيمة الحقيقية لمعلمة encryptionKey واذكر المفتاح المستلم تحت عنوان X-CAP-API-KEY من اعدادات مفتاح الواجهة البرمجية للمنصة، ومعلومات تسجيل الدخول وكلمة المرور المشفرة السابقة في معلمات رقم المعرّف وكلمة المرور.
عند بدء الجلسة، ستتلقى معلمات CST و X-SECURITY-TOKEN في عناوين الرد. يجب استخدام كل من هذه الرموز المميزة في عناوين كل طلب ترسله.