api

واجهة برمجة تطبيقات الأدوات المساعدة

نقاط نهاية الأدوات المساعدة للاستعلام عن الأرصدة وأسعار الصرف والعملات المشفرة المدعومة.

محدث: 9‏/3‏/2026

نقاط نهاية الأدوات المساعدة للاستعلام عن الأرصدة وأسعار الصرف والعملات المشفرة المدعومة.


get-credit-balance

الاستعلام عن رصيد نقاطك الائتمانية. تُستخدم النقاط الائتمانية لنظام خصم الرسوم في QuantaPay.

الطلب

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-credit-balance" \
  -d "api-key=YOUR_API_KEY"

الاستجابة

{
  "success": true,
  "response": {
    "credit_balance": 150.00,
    "credit_currency": "USD"
  }
}
حقلالنوعالوصف
credit_balanceرقمرصيد نقاطك الائتمانية الحالي.
credit_currencyسلسلة نصيةعملة رصيد نقاطك الائتمانية (عادةًUSD).

get-balances

الاستعلام عن أرصدة العملات المشفرة لجميع عناوين محفظتك التي تم تكوينها.

الطلب

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-balances" \
  -d "api-key=YOUR_API_KEY"

الاستجابة

إرجاع بيانات الرصيد لجميع عناوين العملات المشفرة التي تم تكوينها.

{
  "success": true,
  "response": {
    "btc": {
      "amount": "0.5432",
      "fiat": "35210.50"
    },
    "eth": {
      "amount": "12.345",
      "fiat": "45678.90"
    }
  }
}

get-exchange-rates

الحصول على سعر الصرف الحالي بين العملة الورقية والعملة المشفرة.

الطلب

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-exchange-rates" \
  -d "api-key=YOUR_API_KEY" \
  -d "currency_code=USD" \
  -d "cryptocurrency_code=btc"

المعلمات

المعلمةالنوعمطلوبالوصف
currency_codeسلسلة نصيةنعمرمز العملة الورقية (مثل،USD, EUR).
cryptocurrency_codeسلسلة نصيةنعمرمز العملة المشفرة (مثل،btc, eth).

الاستجابة

{
  "success": true,
  "response": "64850.25"
}

الاستجابة هي سعر وحدة واحدة من العملة المشفرة بالعملة الورقية المحددة.


get-fiat-value

تحويل مبلغ من العملة المشفرة إلى ما يعادله من العملة الورقية.

الطلب

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-fiat-value" \
  -d "api-key=YOUR_API_KEY" \
  -d "amount=0.5" \
  -d "cryptocurrency_code=btc" \
  -d "currency_code=USD"

المعلمات

المعلمةالنوعمطلوبالوصف
amountرقمنعممبلغ العملة المشفرة المراد تحويله.
cryptocurrency_codeسلسلة نصيةنعمرمز العملة المشفرة (مثل،btc, eth).
currency_codeسلسلة نصيةنعمرمز العملة الورقية المستهدفة (مثل،USD).

الاستجابة

{
  "success": true,
  "response": "32425.13"
}

get-cryptocurrency-codes

الحصول على قائمة بجميع رموز العملات المشفرة المدعومة وتجميعات الشبكات الخاصة بها.

⚠️ ملاحظة: هذه الدالة مسجلة في موجّه API (api.php) ولكن ليس لديها معالج في الواجهة الخلفية (ajax.php). استدعاؤها سيجتاز التحقق من صحة المعلمات ولكنه سيعيد استجابة فارغة. يجب تنفيذ معالج قبل أن تعمل نقطة النهاية هذه.

الطلب

curl -X POST https://cloud.quantapay.app/api.php \
  -d "function=get-cryptocurrency-codes" \
  -d "api-key=YOUR_API_KEY" \
  -d "cryptocurrency_code="

المعلمات

المعلمةالنوعمطلوبالوصف
cryptocurrency_codeسلسلة نصيةنعممرر سلسلة فارغة للحصول على جميع الرموز، أو اسم blockchain (مثل،eth) للحصول على رموز تلك الشبكة فقط.

الاستجابة المتوقعة

{
  "success": true,
  "response": {
    "BTC": ["btc"],
    "ETH": ["eth", "usdt", "usdc", "link", "shib", "bat"],
    "SOL": ["sol"],
    "TRX": ["usdt_tron"],
    "BSC": ["bnb", "busd", "usdt_bsc"],
    "XRP": ["xrp"],
    "LTC": ["ltc"],
    "DOGE": ["doge"],
    "BCH": ["bch"],
    "ALGO": ["algo"],
    "XMR": ["xmr"]
  }
}

تربط الاستجابة شبكات blockchain برموز العملات المشفرة المدعومة الخاصة بها. يتم تضمين الرموز المخصصة (المضافة عبر الإعدادات ← المدفوعات ← الرمز المخصص) أيضًا.