النقاط

الرصيد والاستهلاك والاسترداد المشترك مع الكمبيوتر.

يعيد GET /credits/balance رصيد الكمبيوتر مع policy: same_as_pc. مصادر النقاط وانتهاؤها وترتيب استهلاكها واستردادها مطابقة للكمبيوتر. لا تمنح API نقاطًا ولا تنشئ محفظة أو جدول حجز منفصلًا.

تُحجز النقاط ذريًا في المعاملة المشتركة مع الكمبيوتر قبل استدعاء Provider. عند تأكيد فشل الإرسال، يُعاد الحجز مرة واحدة فقط. لا يوجد حد يومي منفصل خاص بواجهة API؛ فرصيد نقاط الكمبيوتر المشترك والساري حاليًا في الحساب هو حد النقاط. إذا تجاوزت تكلفة التوليد الرصيد المتاح، تُرجع API الرمز insufficient_credits من دون استدعاء Provider.

مخطط الاستجابة:

{
  "object": "credit_balance",
  "available_credits": 1200,
  "unit": "credits",
  "policy": "same_as_pc"
}