الإدارة

الحصول على رصيد المؤسسة

يعيد مجاميع الرصيد الحالية للمؤسسة المرتبطة برمز الإدارة.

GEThttps://api.tokenlab.sh/v1/management/balance

نظرة عامة

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

ملاحظات

  • تدعم حقول المبالغ المالية الدولار الأمريكي فقط.

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

مثال

الطلب

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

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

توفّر هذه الصفحة مخطط OpenAPI وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من الطرفية أو برنامج العميل باستخدام Management Token؛ لا يتوفر الإرسال المباشر من هذه الصفحة.

الاستجابة

200 OK
{
  "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"
}

حقول مهمة

objectstring
دائمًا organization_balance.
organization_idstring
المؤسسة المرتبطة برمز الإدارة الحالي.
balancenumber
رصيد المؤسسة الحالي بالدولار الأمريكي كـ JSON number للعرض.
balance_decimalstring
رصيد المؤسسة الحالي الدقيق بالدولار الأمريكي كسلسلة عشرية للمطابقة.
total_rechargenumber
إجمالي عمليات الشحن الناجحة للمؤسسة بالدولار الأمريكي كـ JSON number للعرض.
total_recharge_decimalstring
إجمالي عمليات الشحن الناجحة الدقيق للمؤسسة بالدولار الأمريكي كسلسلة عشرية للمطابقة.
total_usednumber
إجمالي إنفاق الاستخدام للمؤسسة بالدولار الأمريكي كـ JSON number للعرض.
total_used_decimalstring
إجمالي إنفاق الاستخدام الدقيق للمؤسسة بالدولار الأمريكي كسلسلة عشرية للمطابقة.

التفويض

ManagementTokenAuth
AuthorizationBearer <token>

مصادقة رمز الإدارة (Management token). قم بإنشاء أو إدارة رموز الإدارة في Dashboard > API > Management Tokens.

الموضع: header

الاستجابة

application/json

application/json

application/json

application/json