نظرة عامة

الرابط الأساسي وأوامر cURL جاهزة للتشغيل متوفرة أدناه. احتفظ بـ api_token سرياً.

المصادقة

قم بتضمين معامل api_token في كل طلب، مثال: ?api_token=YOUR_TOKEN.

يمكنك أيضاً الوصول إلى سجلاتك و أرصدتك عبر البوت
https://t.me/SyriatelCash_Bot

GET /balance

يُرجع آخر رصيد مُسجل للعميل لرقم هاتف محدد.

{
  "success": true,
  "code": "SUCCESS",
  "message": "succeed",
  "status_code": 200,
  "balance": "13338",
  "ts": "2025-01-02T15:34:20.123Z"
}

curl -G "https://api.magnustech.pro/syr-cash/balance" \
  --data-urlencode "api_token=YOUR_TOKEN" \
  --data-urlencode "phone_number=09XXXXXXXXX"

GET /history

يُرجع آخر عمليات الدفع المتاحة لرقم هاتف محدد.

{
  "success": true,
  "code": "SUCCESS",
  "message": "succeed",
  "status_code": 200,
  "price_cents": 200,
  "operations": [
    {
      "transactionNo": "60027...",
      "date": "2025-08-25 22:10:34",
      "from": "0985792792",
      "to": "43888929",
      "status": "1",
      "amount": "57000",
      "fee": "0",
      "net": "57000",
      "channel": "Akrab Elik"
    }
  ]
}

curl -G "https://api.magnustech.pro/syr-cash/history" \
  --data-urlencode "api_token=YOUR_TOKEN" \
  --data-urlencode "phone_number=09XXXXXXXXX"

تنسيق الأخطاء

جميع الأخطاء تتبع شكلاً ثابتاً:

{
  "success": false,
  "code": "INVALID_API_TOKEN",
  "message": "Invalid API token",
  "status_code": 401
}

رموز الأخطاء الشائعة

اختبار الخدمة