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

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

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

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

الخطوات — ربط شام كاش

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

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

2. 2) اربط حساب شام كاش

   من لوحة التحكم → شام كاش → اعرض رمز QR وامسحه من التطبيق وأدخل PIN.

3. 3) انسخ عنوان الحساب

   بعد الربط، انسخ account_address من بطاقة الحساب — تحتاجه بكل طلب API.

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

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

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

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

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

طلب GET لجلب الأرصدة — sham cash api balance:

GET https://tsa-api.com/api/v1?resource=shamcash&action=balance&account_address=YOUR_ADDRESS
Header: X-Api-Key: YOUR_API_KEY

الرد:

{
  "success": true,
  "data": {
    "account_address": "YOUR_ADDRESS",
    "balances": [
      { "currency": "SYP", "balance": 150000 }
    ]
  }
}

مثال PHP — Sham Cash API

$apiKey = "YOUR_API_KEY";
$address = "YOUR_ACCOUNT_ADDRESS";
$url = "https://tsa-api.com/api/v1?resource=shamcash&action=balance&account_address=" . urlencode($address);

$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 sham cash

import requests

API_KEY = "YOUR_API_KEY"
ADDRESS = "YOUR_ACCOUNT_ADDRESS"
url = "https://tsa-api.com/api/v1"
params = {"resource": "shamcash", "action": "balance", "account_address": ADDRESS}
headers = {"X-Api-Key": API_KEY}

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

نصائح مهمة

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