الانتقال إلى المحتوى الرئيسي

نظرة عامة

تعيد نقطة النهاية هذه مجاميع الرصيد الحالية للمؤسسة المرتبطة برمز الإدارة. وهي تستخدم مصدر الحقيقة نفسه لرصيد المؤسسة المستخدم في الفوترة والتسوية.

ملاحظات

  • يتم إرجاع حقول المبالغ بالدولار الأمريكي. استخدم balance و total_recharge و total_used للعرض، واستخدم balance_decimal و total_recharge_decimal و total_used_decimal للمطابقة الدقيقة.

مثال

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

الطلب / الاستجابة

استخدم لوحة OpenAPI التفاعلية أعلاه للحصول على المخطط الدقيق.

مثال الاستجابة

{
  "object": "organization_balance",
  "organization_id": "org_123",
  "balance": 42.5,
  "balance_decimal": "42.50",
  "total_recharge": 100,
  "total_recharge_decimal": "100",
  "total_used": 57.5,
  "total_used_decimal": "57.50"
}

حقول مهمة

object
string
دائمًا organization_balance.
organization_id
string
المؤسسة المرتبطة برمز الإدارة الحالي.
balance
number
رصيد المؤسسة الحالي بالدولار الأمريكي كـ JSON number للعرض.
balance_decimal
string
رصيد المؤسسة الحالي الدقيق بالدولار الأمريكي كسلسلة عشرية للمطابقة.
total_recharge
number
إجمالي عمليات الشحن الناجحة للمؤسسة بالدولار الأمريكي كـ JSON number للعرض.
total_recharge_decimal
string
إجمالي عمليات الشحن الناجحة الدقيق للمؤسسة بالدولار الأمريكي كسلسلة عشرية للمطابقة.
total_used
number
إجمالي إنفاق الاستخدام للمؤسسة بالدولار الأمريكي كـ JSON number للعرض.
total_used_decimal
string
إجمالي إنفاق الاستخدام الدقيق للمؤسسة بالدولار الأمريكي كسلسلة عشرية للمطابقة.