Source: https://ailoot.ai/docs/ar/cabinet/
Canonical: https://ailoot.ai/docs/ar/cabinet/
Language: ar

[API لوحة الحساب](https://ailoot.ai/docs/ar/) 

# API لوحة الحساب

[Markdown](https://ailoot.ai/docs/ar/cabinet/index.md)

طرق لوحة الحساب الشخصية: تسجيل الدخول والملف الشخصي والمفاتيح وسجل التكاليف.

هذه API لوحة الحساب الشخصية على ailoot.ai: تسجيل الدخول والملف الشخصي والمفاتيح وسجل التكاليف. تُرسل طلبات النماذج إلى عنوان آخر — `https://api.ailoot.ai` باستخدام المفتاح `sk-…`. يعتمد الوصول إلى الطرق على صلاحيات حسابك والميزات المفعّلة.

## [](https://ailoot.ai/docs/ar/cabinet/#adresa-i-avtorizatsiya)العناوين والمصادقة

- لوحة الحساب: https://ailoot.ai (تسجيل الدخول باسم المستخدم، وتوكن لوحة الحساب)
- API النماذج: https://api.ailoot.ai (مفتاح sk-…)

| العنصر | العنوان | المصادقة |
| --- | --- | --- |
| API لوحة الحساب | `https://ailoot.ai/api/v1` | `Authorization: Bearer $TOKEN` — توكن لوحة الحساب بعد تسجيل الدخول |
| API النماذج | `https://api.ailoot.ai/v1` | المفتاح `sk-…` من قسم «مفاتيح API»؛ انظر [المفاتيح وعنوان API](https://ailoot.ai/docs/ar/keys/) |

المفتاح `sk-…` لا يحل محل توكن لوحة الحساب، وتوكن لوحة الحساب لا يتيح API النماذج. يُذكر المسار الكامل عند كل طريقة.

قراءة ملفك الشخصي

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/user/profile" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/ar/cabinet/#format-otveta-i-oshibki)صيغة الرد والأخطاء

يتضمن الرد code وmessage وdata. قد يتضمن الخطأ reason وmetadata. يتضمن تقسيم الصفحات في data الحقول items وtotal وpage وpage\_size وpages. صيغة كل طريقة موضحة في وصفها.

بنية الرد ذي الصفحات

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [],
    "total": 0,
    "page": 1,
    "page_size": 20,
    "pages": 1
  }
}
```

يُتحقق من صلاحية توكن لوحة الحساب ومن نشاط المستخدم؛ وإذا فُعّلت ربط الجلسة، يُتحقق أيضاً من IP والمتصفح. تميز الرموز TOKEN\_EXPIRED وTOKEN\_REVOKED وUSER\_INACTIVE وINVALID\_TOKEN وFORBIDDEN بين مشكلات الجلسة والصلاحيات. قد يمنع حد المعدل أو تأكيد 2FA إضافي طلباً محدداً.

## [](https://ailoot.ai/docs/ar/cabinet/#kak-chitat-spravochnik)كيفية قراءة المرجع

- تتضمن كل مادة طريقة HTTP والمسار الكامل وشروط الوصول والمعاملات وحقول الجسم والرد.
- خذ المعرّفات من رد سابق: KEY\_ID من GET /api/v1/keys، ومعرّف الطلب من GET /api/v1/usage.
- حقول الكائنات وأنواعها موضحة في صفحات «مخططات البيانات».
- تعرض القوالب أسماء الحقول وأنواعها. PLACEHOLDER وTOKEN علامتان تمثيليتان، ولا توجد بيانات حقيقية هنا.
- شحن الرصيد في قسم «الباقات» بلوحة الحساب: [كيفية شحن الرصيد](https://ailoot.ai/docs/ar/billing/topup/).

## [](https://ailoot.ai/docs/ar/cabinet/#balans-i-frozen-balance)الرصيد وfrozen\_balance

يتضمن الملف الشخصي balance وfrozen\_balance. frozen\_balance هو المبلغ المحجوز لطلبات لم تكتمل. تحقق من الحقلين مع السجل.

## [](https://ailoot.ai/docs/ar/cabinet/#klyuchi-i-limity)المفاتيح والحدود

يعيد GET /api/v1/keys مفاتيحك. الحقول `quota` و `quota_used` — حد إنفاق المفتاح والجزء المستخدم منه؛ `ip_whitelist`, `ip_blacklist`, `status` و `expires_at` تتحكم في استخدام المفتاح؛ `rate_limit_5h`, `rate_limit_1d` و `rate_limit_7d` — حدود الإنفاق لكل نافذة زمنية.

القائمة ومفتاحك الخاص

```bash
curl --fail-with-body "https://ailoot.ai/api/v1/keys" \
  -H "Authorization: Bearer $TOKEN"

# KEY_ID هو id الخاص بمفتاحك من استجابة القائمة
curl --fail-with-body "https://ailoot.ai/api/v1/keys/$KEY_ID" \
  -H "Authorization: Bearer $TOKEN"
```

## [](https://ailoot.ai/docs/ar/cabinet/#rashody-i-bezopasnost)التكاليف والأمان

يعرض السجل وdashboard الحقل actual\_cost بوصفه الخصم الفعلي، والحقل total\_cost بوصفه التكلفة بالسعر القياسي. تُذكر فلاتر التاريخ والنموذج والمفتاح ونوع الطلب عند الطريقة. تتطلب تغييرات كلمة المرور وTOTP وpasskey التأكيدات الموضحة عند طرقها.

في هذا القسم: `39` طريقة.

هل لديك أسئلة أخرى؟ أرسل Request ID ووصفاً للمشكلة وسنساعدك على فهمها.[مراسلة الدعم](mailto:support@ailoot.ai)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.