الاستخدام

بالنسبة لعمليات التكامل الخارجية، فإن التحقق من الحساب الثابت اليوم هو الملف الشخصي. استخدمه لقراءة الاعتمادات والمستوى وحصة API المتبقية قبل العمليات الكبيرة. يجب التعامل مع نقاط نهاية الاستخدام المخصصة على أنها تعتمد على المخطط: استدعاء المسارات الموجودة في GET /api/openapi.json فقط.

طلب

يستخدم الملف الشخصي طلبًا عاديًا لمصادقة الحامل:

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

إجابة

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

استخدم الاستجابة لحواجز الحماية التشغيلية، وليس كحجز. قد يستهلك العمال الآخرون الرصيد بعد التحقق منه.

الفواتير والائتمانات

تخزين لقطات التوازن حول دفعات باهظة الثمن. إذا سأل العملاء عن سبب توقف الدفعة، فقم بمقارنة لقطة ملف تعريف البداية وعدد المهام المكتملة وعدد المهام الفاشلة ولقطة ملف التعريف النهائية.

أخطاء

تتبع أخطاء ملف التعريف شكل الخطأ API المشترك. إذا ظهرت نقطة نهاية للاستخدام المستقبلي في المخطط، فقم بتطبيق نفس قواعد إعادة المحاولة والتسجيل: سجل requestId، وتجنب تسجيل مفاتيح API، وأوقف إنشاء الدُفعة مؤقتًا عند عدم كفاية الاعتمادات.