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