حزم SDK
حزمة SDK توقّع كل استدعاء، وتتحقق من الردود المهمة، وتصوغ طلبات الشراء بحيث لا تقع الأخطاء المكلفة بصمت — الشراء مرتين، أو ضياع رموز البطاقات، أو الثقة بردّ مزوّر. وكل حزمة تُفحص مقابل مجموعة الرسائل النموذجية نفسها، المثبتة مقابل شيفرة أنيس ذاتها.
أداة مساعدة اختيارية، تُقدَّم كما هي
كل حزم SDK من أنيس مجانية وتُقدَّم بموجب رخصة MIT «كما هي»، دون أي ضمان من أي نوع. ولا تتحمّل أنيس (Aniscom for Technical Services) أي مسؤولية أو التزام عن استخدامها أو عن أي خسارة تنشأ عنه. وتبقى أنت المسؤول عن ربط نظامك — تسجيل طلبات الشراء قبل إرسالها، والاستئناف، وحفظ المفاتيح، والاختبار. الشيفرة المصدرية علنية: اقرأها لتفهم بدقة ما تفعله قبل أن تعتمد عليها. ولا تحتاج إلى حزمة SDK أصلًا — يمكنك استدعاء واجهة API لشركاء أنيس مباشرة باتباع دليل الاستخدام وصفحة مرجع API.
يضيف الإصدار 2.2.0 من حزم SDK meterCharges وdirectRechargeProducts (المنتجات والمواقع وحساب السعر) وdirectRecharges (الإنشاء وقائمة عملياتك والقراءة وتعديل المستلم) وwebhookEndpoint وwebhookEvents وأداة للتحقق من توقيع الإشعارات وأنواع الأخطاء المحدّثة. حدّث من الإصدار 2.1.0 لاستخدامها. راجع أدلة العدادات والشحن المباشر والإشعارات لمعرفة سلوك HTTP. احفظ معرّف العملية ومحتواها كما سترسله قبل أي استدعاء ينقل مالًا؛ واستعد الردّ الضائع بالمعرّف نفسه. يذكر ملف README في كل حزمة وملف docs/webhooks.md فيها أسماء الدوال ومعاملات أداة التحقق.
ما تفعله حزمة SDK
- توقّع كل استدعاء تمامًا كما يصف دليل توقيع الاستدعاءات.
- تتحقق من كل ردّ على الاستدعاءات التي توقّع أنيس ردودها — طلبات الشراء والكشف وتسجيل المفتاح والفحص الذاتي للتوقيع وتعليق تطبيقك وإلغاء مفتاح — وتتخلص من أي ردّ لا تستطيع التحقق منه. ولا تتحقق من استدعاءات المعلومات (ملف التطبيق والمحافظ والكتالوج والبطاقات المملوكة) لأن ردودها غير موقَّعة. إصدارات 1.x مهجورة: استخدم الإصدار 2.2.0، وهو الأحدث.
- لا تخترع معرّف عملية طلب الشراء أبدًا، وتخبرك لكل طلب شراء مرفوض هل تمّ.
- تبلّغ عن كل استدعاء في سجلاتك وتتبّعك ومقاييسك دون تسجيل أي سرّ.
.NET
متاحة C#. لـ .NET 8 و .NET 10. اقرأ الدليل.
- الحزمة:
Anis.Partners - استخدم الإصدار
2.2.0أو أحدث - الشيفرة المصدرية: github.com/anis-ly/anis.partners-sdk-dotnet
PHP
متاحة PHP. لـ PHP من 8.2 إلى 8.5، مع أي عميل HTTP يتبع PSR-18. اقرأ الدليل.
- الحزمة:
anis-ly/partners - استخدم الإصدار
2.2.0أو أحدث - الشيفرة المصدرية: github.com/anis-ly/anis.partners-sdk-php
TypeScript
متاحة TypeScript / Node.js. لـ Node.js 22 وما بعده، بوحدات ES و CommonJS. اقرأ الدليل.
- الحزمة:
@anis-ly/partners - استخدم الإصدار
2.2.0أو أحدث - الشيفرة المصدرية: github.com/anis-ly/anis.partners-sdk-node
Python
متاحة Python. لـ Python من 3.11 إلى 3.14، بنسختين متزامنة وغير متزامنة. اقرأ الدليل.
- الحزمة:
anis-partners - استخدم الإصدار
2.2.0أو أحدث - الشيفرة المصدرية: github.com/anis-ly/anis.partners-sdk-python