اربط شام كاش باستخدام بايثون.
مكتبة مفتوحة المصدر لربط تطبيقك بمنصتنا البرمجية المستقلة. تتيح ربط الحسابات، وقراءة الأرصدة والحوالات الواردة، وإدارة الاشتراكات، بطريقتي التنفيذ المتزامن وغير المتزامن.
pip install shamcashتعمل مع الإصدار 3.8 وما بعده. تُعاد المبالغ بأعداد عشرية دقيقة، والتواريخ مع منطقتها الزمنية.
قبل أول طلب
- أنشئ حساباً في المنصة، واربط حساب شام كاش بمسح رمز الربط.
- فعّل تجربة مؤهلة أو اشتراكاً مدفوعاً للحساب المرتبط.
- أنشئ مفتاحك البرمجي من لوحة التحكم. احتفظ به في الخادم، خارج الكود المنشور وكود المتصفح.
اقرأ الأرصدة والحوالات الواردة
from shamcash import ShamCashAPISync
with ShamCashAPISync(api_token="YOUR_API_TOKEN") as client:
accounts = client.list_accounts()
account = accounts[0]
balances = client.get_balances(account.id)
transfers = client.list_transactions(account.id, limit=20)
for transfer in transfers.transactions:
print(transfer.transaction_id, transfer.amount)يفترض المثال وجود حساب مرتبط واحد على الأقل. في التطبيق الفعلي، حدّد معرّف الحساب المطلوب وعالج أخطاء الواجهة وحدود الطلبات.
ابنِ آلية الدفع في تطبيقك
تقرأ المكتبة بيانات الحساب. يتولى تطبيقك إنشاء الفواتير، ومطابقة أرقام العمليات أو مراجع الملاحظات، وإضافة الرصيد مرة واحدة. استخدم عامل جلب مشتركاً لكل حساب مرتبط مع احترام حد الطلبات.
شاهد طرق ربط المدفوعاتربط الحسابات والاشتراكات
تدعم المكتبة جلسات الربط وإعادة الربط، والاشتراكات المدفوعة مسبقاً، والتجديد التلقائي، وإلغاء الربط. فعّل إذن إدارة الحسابات على مفتاحك قبل استخدام العمليات التي تعدّل الحساب أو الاشتراك. لا تحتاج طلبات القراءة إلى هذا الإذن.
اقرأ أمثلة المكتبة على غيت هاب