رصيد الحساب

يُعيد رصيد المحفظة المرتبطة بالمفتاح. راقبوه في تطبيقاتكم : رصيد صفري يتسبب في 402 على الاستدعاءات المفوترة التالية ؛ وتبقى قراءة الرصيد وقائمة النماذج متاحتين.

الطلب#

curl https://api.cloudzir.com/v1/user/balance \
  -H "Authorization: Bearer $CLOUDZIR_API_KEY"

import httpx

r = httpx.get(
    "https://api.cloudzir.com/v1/user/balance",
    headers={"Authorization": f"Bearer {cle}"},
    timeout=20,
)
info = r.json()["balance_infos"][0]
solde = float(info["total_balance"])
if solde < 500:
    alerter(f"Solde CloudZIR bas : {solde:.2f} DA")

const r = await fetch("https://api.cloudzir.com/v1/user/balance", {
  headers: { Authorization: `Bearer ${cle}` },
});
const { balance_infos } = await r.json();
const solde = Number(balance_infos[0].total_balance);
if (solde < 500) alerter(`Solde CloudZIR bas : ${solde.toFixed(2)} DA`);

الاستجابة#

{
  "object": "user.balance",
  "is_available": true,
  "balance_infos": [
    {
      "currency": "DZD",
      "total_balance": "4820.5000"
    }
  ]
}

مراقبة رصيدكم#

هذا الاستدعاء لا يستهلك أي رمز ويعمل حتى عند نفاد الرصيد. استخدامان موصى بهما :

• فحص دوري (كل ساعة) ينبّه تحت عتبة معينة؛ أكثر راحة بكثير من اكتشاف 402 في الإنتاج.
• عند 402 : استعلام الرصيد للتمييز بين «حساب فارغ» ومشكلة أخرى، وعرض رسالة واضحة لفرقكم.

SEUIL_DA = 500

def verifier_solde(cle: str) -> None:
    r = httpx.get("https://api.cloudzir.com/v1/user/balance",
                  headers={"Authorization": f"Bearer {cle}"}, timeout=20)
    r.raise_for_status()
    info = r.json()["balance_infos"][0]
    solde = float(info["total_balance"])
    if solde <= 0:
        alerter("CRITIQUE : portefeuille CloudZIR vide, les appels échouent en 402")
    elif solde < SEUIL_DA:
        alerter(f"Solde CloudZIR bas : {solde:.2f} DA - penser à recharger")

الشحن#

من plateforme.cloudzir.com/topup : تظهر وسائل الدفع المقترحة في صفحة Top up على المنصة. يتم الإضافة إلى الرصيد بعد التحقق بالنسبة للتحويلات اليدوية. لا حاجة إلى أي إجراء تقني بعد ذلك : تستأنف الاستدعاءات فور أن يصبح الرصيد موجبًا.