مقدمة

تتيح لك واجهة سما برايم API قراءة محفظة المستخدم وإنشاء طلبات — أرقام SMS، خدمات SMM، الاستعلام عن البطاقات — عبر HTTPS مباشرة، وباستخدام نفس منطق التسعير والعمل الذي يستخدمه تطبيق سما برايم نفسه.

كل استجابة بصيغة JSON، ضمن غلاف ثابت: الطلب الناجح يعيد { "data": ..., "meta": { "request_id", "timestamp" } }، والخطأ يعيد { "error": { "type", "message", "code", "request_id" } }.

هذا المرجع مقسّم حسب المورد — المحفظة، SMS، SMM، البطاقات، Webhooks — بالإضافة إلى قسم نظرة عامة مشترك يغطي المصادقة والأخطاء وحدود الطلبات والتكرار الآمن والترقيم، وتنطبق جميعها على كل نقطة نهاية.

نقاط النهاية تُطلق تدريجياً. تذكر كل صفحة نقطة نهاية الصلاحية المطلوبة لها حتى تطلب فقط ما يحتاجه تكاملك.