جلب الرصيد

يعيد رصيد USD الحالي للحساب الموثق.

جلب الرصيد

GET /v1/balance

curl -X GET "https://api.zelnum.com/api/v1/balance" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "balance": "5.230000"
}

الحقل	النوع	الوصف
`balance`	string	الرصيد المتاح بالدولار الأمريكي، بست خانات عشرية ثابتة.

معلومات المفتاح

يُرجع بيانات المفتاح المستخدم في الطلب. لا يُعاد المفتاح السري نفسه أبدًا، بل بادئة مُقنّعة فقط، لتعرف أي مفتاح استُخدم دون كشف بيانات الاعتماد.

GET /v1/api-key

curl -X GET "https://api.zelnum.com/api/v1/api-key" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "api_key_id": 12,
  "masked_key": "ck_xxxxxxxxx…****",
  "last_used": "2026-09-12T09:14:03.000000Z",
  "created_at": "2026-08-30T11:02:44.000000Z"
}

الحقل	النوع	الوصف
`api_key_id`	integer	معرّف المفتاح، مفيد عند التواصل مع الدعم.
`masked_key`	string	بادئة مُقنّعة. لا يُعاد المفتاح بنصه الصريح هنا أبدًا.
`last_used`	string \| null	وقت آخر طلب تم التحقق منه باستخدام هذا المفتاح.
`created_at`	string	وقت إنشاء المفتاح.

تُحدَّد طلبات واجهة API لكل مفتاح ولكل مجموعة نقاط نهاية:

نقاط النهاية	الحد
`GET /v1/balance` · `GET /v1/api-key`	60 طلباً / دقيقة لكل مفتاح API (120 / دقيقة لكل IP)

الأخطاء

الحالة	`code`	السبب
`401`	`unauthorized`	مفتاح API مفقود أو غير صالح أو معطّل.
`403`	`account_banned`	الحساب موقوف. تواصل مع الدعم.
`429`	—	تم بلوغ حد الطلبات — راجع حدود المعدل.

تشترك نقطتا النهاية في الحاوية العامة نفسها: 60 طلبًا / دقيقة لكل مفتاح API.