كيف تربط سرياتل كاش بموقعك؟

ما الذي تحتاجه؟

• حساب على tsa-api.com
• حساب سرياتل كاش مفعّل على تطبيق أقرب إليك
• الرقم الأساسي وكلمة سر التطبيق
• موقع أو تطبيق يدعم HTTP (PHP، Python، Node.js…)

التجربة المجانية 24 ساعة — حسابين. بعدها اشتراك شهري 5$.

الخطوات — ربط سرياتل كاش

1. 1) أنشئ حساباً

   سجّل على إنشاء حساب — ستحصل فوراً على api_key خاص بك.

2. 2) اربط حساب سرياتل كاش

   من لوحة التحكم → سيرياتيل كاش → أدخل الرقم الأساسي وكلمة سر التطبيق.

3. 3) أكّد برمز SMS

   إذا طُلب التحقق، أدخل رمز SMS — تُربط كل خطوط الحساب تلقائياً.

4. 4) انسخ رقم الخط (gsm)

   بعد الربط، انسخ gsm من بطاقة الخط — مثل 09330000001. استخدمه بكل طلب API.

5. 5) أرسل طلب API

   استخدم مفتاحك في Header: X-Api-Key — العنوان: https://tsa-api.com/api/v1

6. 6) اقرأ الرد JSON

   رصيد، سجلات واردة/صادرة، تحويل، شحن — راجع التوثيق الكامل.

مثال: جلب رصيد سرياتل كاش

طلب GET لجلب الرصيد — syriatel cash api balance:

GET https://tsa-api.com/api/v1?resource=syriatel&action=balance&gsm=09330000001
Header: X-Api-Key: YOUR_API_KEY

الرد:

{
  "success": true,
  "data": { "gsm": "09330000001", "balance": "482500" }
}

استخدم gsm (رقم الموبايل) — لا تستخدم cash_code مكانه.

مثال: سجلات واردة

GET https://tsa-api.com/api/v1?resource=syriatel&action=history&gsm=09330000001&period=7
Header: X-Api-Key: YOUR_API_KEY

مثال PHP — Syriatel Cash API

$apiKey = "YOUR_API_KEY";
$gsm = "09330000001";
$url = "https://tsa-api.com/api/v1?resource=syriatel&action=balance&gsm=" . urlencode($gsm);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: $apiKey"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

مثال Python — connect syriatel cash

import requests

API_KEY = "YOUR_API_KEY"
GSM = "09330000001"
url = "https://tsa-api.com/api/v1"
params = {"resource": "syriatel", "action": "balance", "gsm": GSM}
headers = {"X-Api-Key": API_KEY}

r = requests.get(url, params=params, headers=headers)
print(r.json())

نصائح مهمة

• لا تشارك مفتاح API أو كلمة سر التطبيق — خزّنهما في متغيرات بيئة على السيرفر.
• استخدم HTTPS دائماً عند الاتصال بـ https://tsa-api.com.
• التحويل وشحن الرصيد يحتاجان pin_code في Body — لا تضعه في الرابط.
• إذا انتهى الاشتراك، API يرد بـ انتهى الاشتراك — جدّد عبر الدعم.
• شام كاش API متاح على نفس المنصة — راجع دليل شام كاش.