تسجيل الدخول والحصول على الرموز
Log In for Tokens
احصل على access token وrefresh token باستخدام اسم المستخدم وكلمة المرور.
POST
https://console.synleapenergy.com/open-api/v1/token/login معاملات المحتوىapplication/json
userNamestringمطلوباسم المستخدم، حتى 64 حرفًا.
passwordstringمطلوبكلمة المرور، حتى 72 حرفًا.
ملاحظات الاستخدام
- تظل access token صالحة لمدة 24 ساعة وrefresh token لمدة 90 يومًا.
الاستجابات
200استجابة ناجحةapplication/json
| الحقل | النوع | الوصف |
|---|---|---|
accessToken | string | رمز access token لاستدعاءات الأعمال |
refreshToken | string | رمز refresh token لتجديد الرموز |
accessExpiresAt | integer | انتهاء access token (طابع Unix الزمني بالمللي ثانية) |
refreshExpiresAt | integer | انتهاء refresh token (طابع Unix الزمني بالمللي ثانية) |
4xx / 5xxاستجابة خطأapplication/json
| حالة HTTP | رمز الخطأ | الوصف |
|---|---|---|
| 400 | 400 | طلب تسجيل الدخول غير صالح. تحقق من إدخال userName وpassword وعدم تجاوز حدود الطول. |
| 403 | 1050041007 | لا يُسمح بـ visit-tenant-id |
| 429 | 1050041008 | تجاوز الحد؛ انتظر عدد الثواني في Retry-After |
| 429 | 1050041010 | يحتوي الحساب على أكثر من 10 رموز في الوقت نفسه. |
| 401 | 1050041014 | فشل مصادقة تسجيل الدخول |
| 503 | 500 | الخدمة غير متاحة مؤقتًا. حاول مرة أخرى لاحقًا. |