الإدارة

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

الحصول على الرصيد، وعمليات الشحن، وإجمالي الإنفاق لمساحة العمل الحالية.

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

نظرة عامة

إرجاع الرصيد، وإجمالي عمليات الشحن، وإجمالي الإنفاق لمساحة العمل المرتبطة بـ management token.

ملاحظات

  • الحقول المالية هي بالدولار الأمريكي (USD) فقط.

  • يتم إرجاع المبالغ بالدولار الأمريكي. استخدم 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 وأمثلة طلبات قابلة للنسخ. أرسل طلبات الإدارة من جهازك الطرفي (terminal) أو العميل باستخدام 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
المؤسسة المرتبطة بـ management token الحالي.
balancenumber
رصيد المؤسسة الحالي بالدولار الأمريكي كرقم JSON للعرض.
balance_decimalstring
رصيد المؤسسة الحالي الدقيق بالدولار الأمريكي كسلسلة نصية عشرية للمطابقة المالية.
total_rechargenumber
إجمالي مبلغ شحن المؤسسة الناجح بالدولار الأمريكي كرقم JSON للعرض.
total_recharge_decimalstring
إجمالي مبلغ شحن المؤسسة الناجح الدقيق بالدولار الأمريكي كسلسلة نصية عشرية للمطابقة المالية.
total_usednumber
إجمالي إنفاق المؤسسة بالدولار الأمريكي كرقم JSON للعرض.
total_used_decimalstring
إجمالي إنفاق المؤسسة الدقيق بالدولار الأمريكي كسلسلة نصية عشرية للمطابقة المالية.

التفويض

ManagementTokenAuth
AuthorizationBearer <token>

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

الموضع: header

الاستجابة

application/json

application/json

application/json

application/json