تخطَّ إلى المحتوى
مرجع API
مرجع API

استرداد الرصيد

استرداد الرصيد المدفوع والمكافآت المتبقية إضافةً إلى إجمالي الاستخدام الحالي.

عرض Markdown

استرداد الرصيد المدفوع والمكافآت المتبقية إضافةً إلى إجمالي الاستخدام الحالي.

نقطة النهاية

GET /api/v1/me/balance
عنوان URL الأساسي
https://runapi.ai
إصدار API
v1
المصادقة
Authorization: Bearer YOUR_API_KEY
التفويض
يُرجع الرصيد للحساب المرتبط بمفتاح API القياسي المقدَّم.
02

استجابة النجاح

HTTP 200

GET /api/v1/me/balance

JSON 
{
  "balance_cents": 1200,
  "bonus_balance_cents": 200,
  "paid_balance_cents": 1000,
  "spent_cents_today": 75,
  "spent_cents_total": 4300
}
03

استجابة الخطأ (401)

HTTP 401
مخطط الاستجابة
JSON 
{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

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

JSON 
{
  "error": "Authentication required"
}
04

استجابة الخطأ (403)

HTTP 403
مخطط الاستجابة
JSON 
{
  "properties": {
    "error": {
      "description": "رسالة خطأ قابلة للقراءة البشرية.",
      "type": "string"
    }
  },
  "required": [
    "error"
  ],
  "type": "object",
  "unevaluatedProperties": false
}

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

JSON 
{
  "error": "Standard API key required"
}
05

مثال cURL

CURL 
curl -X GET https://runapi.ai/api/v1/me/balance \
  -H 'Authorization: Bearer YOUR_API_KEY'