مقدمة

ما هي واجهة منطاد API، وكيف يُنظَّم هذا المرجع.

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

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

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

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