إذا كنت تدير نشاطًا تجاريًا لموزع SMM، فإن استخدام واجهة برمجة التطبيقات (API) لتوصيل اللوحة الخاصة بك بمزود البيع بالجملة هو الخطوة التي تحول العمل الجانبي اليدوي إلى عمل آلي قابل للتطوير. يشرح هذا الدليل ماهية واجهة برمجة تطبيقات لوحة SMM، وكيفية توصيل لوحة فرعية بـ Resimi، وما يتضمنه التكامل فعليًا من الناحية الفنية.
ما هي واجهة برمجة تطبيقات لوحة SMM؟
تعد واجهة برمجة التطبيقات (واجهة برمجة التطبيقات) طريقة موحدة للتواصل بين نظامين برمجيين. في سياق SMM، تتيح واجهة برمجة تطبيقات اللوحة للبرامج الخارجية - موقع الويب الخاص بك، أو اللوحة ذات العلامة التجارية الخاصة بك، أو تطبيق مخصص - إرسال الطلبات إلى لوحة البيع بالجملة وتلقي تحديثات الحالة مرة أخرى، كل ذلك تلقائيًا.
لقد تم توحيد صناعة SMM إلى حد كبير على تنسيق API واحد. تستخدم معظم برامج اللوحة والبرامج النصية وحلول اللوحة الفرعية نفس بنية نقطة النهاية الأساسية، مما يعني أن أي برنامج لوحة فرعية تختاره يتوافق بالتأكيد مع واجهة برمجة التطبيقات الخاصة بـ Resimi دون تخصيص.
كيف تعمل واجهة برمجة تطبيقات Resimi
يتم إرسال جميع الطلبات كـ HTTP POST إلى resimi.xyz/api/v2.php مع تضمين مفتاح API الخاص بك في كل طلب. الإجراءات الأساسية الأربعة:
احصل على الخدمات
إرجاع القائمة الكاملة للخدمات النشطة مع معرفاتها وأسعارها والحد الأدنى/الحد الأقصى للكميات والمعلمات الأخرى. تستدعي اللوحة الفرعية الخاصة بك هذا لملء قائمة الخدمات الخاصة بها، بحيث تظل قائمة الأسعار الخاصة بك متزامنة تلقائيًا مع كتالوج Resimi.
key=YOUR_KEY&action=services
وضع النظام
يقدم طلبًا جديدًا للمعالجة. إرجاع معرف الطلب الذي تستخدمه لتتبع الحالة.
key=YOUR_KEY&action=add&service=SERVICE_ID&link=TARGET_URL&quantity=1000
حالة الطلب
إرجاع الحالة الحالية للطلب (معلق، قيد التقدم، مكتمل، جزئي، ملغي) بالإضافة إلى عدد البدء، والعدد الحالي، والكمية المتبقية.
key=YOUR_KEY&action=status&order=ORDER_ID
التحقق من الرصيد
إرجاع رصيد محفظتك الحالية والعملة.
key=YOUR_KEY&action=balance
إعداد لوحة فرعية
اللوحة الفرعية هي لوحة SMM ذات علامتك التجارية الخاصة - مجالك الخاص، وشعارك الخاص، وقائمة الأسعار الخاصة بك - مدعومة بخدمات Resimi على الواجهة الخلفية. عندما يطلب العميل من خلال اللوحة الخاصة بك، يتم تمرير الطلب تلقائيًا إلى Resimi، ويتم التسليم من خلال البنية التحتية لـ Resimi. لا يعرف عميلك أبدًا مزود البيع بالجملة الذي تستخدمه.
ما تحتاجه
- اسم النطاق: ستتواجد اللوحة الفرعية الخاصة بك في نطاقك الخاص (على سبيل المثال، yourpanel.com). النطاقات الرخيصة أو المجانية من مقدمي خدمات مثل Namecheap تعمل بشكل جيد للبدء.
- الاستضافة المشتركة أو VPS: تعد الاستضافة المشتركة مثل Namecheap أو Hostinger كافية لمعظم اللوحات الفرعية. مطلوب دعم PHP 7.4+.
- برنامج لوحة الطفل: تم تصميم العديد من البرامج النصية المستندة إلى PHP خصيصًا لهذا الغرض. ابحث عن تلك التي تدعم بشكل صريح تنسيق SMM API القياسي - سيكون لديها شاشة تكوين الموفر حيث تقوم بإدخال نقطة نهاية Resimi API ومفتاحك.
- مفتاح Resimi API الخاص بك: يمكن العثور عليها في صفحة الوصول إلى واجهة برمجة التطبيقات (API Access) في لوحة تحكم Resimi الخاصة بك
خطوات التكوين
- قم بتثبيت برنامج اللوحة الفرعية الخاص بك على الاستضافة الخاصة بك (عادةً ما تكون عملية تحميل ملف أو نقرة واحدة)
- في إعدادات مسؤول اللوحة، انتقل إلى قسم "موفر واجهة برمجة التطبيقات" (API Provider) أو "موفر الخدمات" (Services Provider).
- أدخل
https://resimi.xyz/api/v2.phpكعنوان URL لواجهة برمجة التطبيقات - أدخل مفتاح Resimi API الخاص بك
- قم بتشغيل وظيفة "استيراد الخدمات" - وهذا يؤدي إلى سحب قائمة خدمات Resimi الكاملة إلى اللوحة الخاصة بك تلقائيًا
- قم بتعيين الترميز الخاص بك على كل فئة خدمة (على سبيل المثال 2× على خدمات Instagram، 3× على YouTube)
- قم بإعداد طرق الدفع لعملائك (الخيارات الشائعة: التشفير عبر NOWPayments، وStripe لمدفوعات البطاقات)
تسعير لوحة طفلك بشكل صحيح
يجب أن يغطي السعر الذي تقدمه للعملاء ثلاثة أشياء: سعر الجملة لشركة Resimi، والهامش المطلوب، وأي رسوم معالجة دفع من بوابة الدفع الخاصة بك. صيغة بسيطة:
سعر العميل = (سعر الرسيمي × هامش الربح) + المبلغ العازل لرسوم الدفع
إذا كانت Resimi تتقاضى 1.84 دولارًا أمريكيًا/1 ألفًا مقابل خدمة ما وتريد زيادة قدرها 2.5×، فإنك تفرض على العملاء 4.60 دولارًا أمريكيًا/1 ألفًا. إذا كان معالج الدفع الخاص بك يتقاضى 3%، فقم بإضافة ذلك إلى السعر الخاص بك للتأكد من أنك لا تأكله.
حدود معدل API وأفضل الممارسات
تسمح واجهة برمجة تطبيقات Resimi بـ 60 طلبًا في الدقيقة. بالنسبة لمعظم اللوحات الفرعية، يعد هذا أكثر من كافٍ - فقد تقدم اللجنة المزدحمة بضع مئات من الطلبات يوميًا، وليس في الدقيقة. بعض الممارسات الفنية للحفاظ على سير الأمور بسلاسة:
- قم بتخزين قائمة الخدمات محليًا وتحديثها مرة واحدة كل ساعة بدلاً من استدعاء واجهة برمجة التطبيقات (API) عند كل تحميل للصفحة
- استخدم وظائف الخلفية (مهام cron) للتحقق من حالة الطلب بدلاً من التحقق من الحالة في كل طلب صفحة
- تعامل مع أخطاء واجهة برمجة التطبيقات بأمان - إذا فشل الطلب، أعد المحاولة مرة واحدة قبل ظهور خطأ للعميل
- قم بتخزين مفتاح واجهة برمجة التطبيقات (API) الخاص بك في متغير بيئة أو ملف تكوين، ولا يتم ترميزه مطلقًا في تعليمات برمجية يمكن الوصول إليها بشكل عام
الحصول على مفتاح API الخاص بك
يتم إنشاء مفتاح API الخاص بك تلقائيًا عند إنشاء حساب Resimi. يمكنك العثور عليه — وتجديده إذا لزم الأمر — على صفحة الوصول إلى واجهة برمجة التطبيقات (API). في لوحة القيادة الخاصة بك. أبقِ الأمر سريًا؛ يمكن لأي شخص لديه مفتاح API الخاص بك تقديم طلبات يتم تحميلها على رصيدك.
هل لوحة الطفل مناسبة لك؟
تصبح اللوحة الفرعية منطقية بمجرد أن يكون لديك عملاء ثابتون وتقضي وقتًا مفيدًا في تقديم الطلبات يدويًا. إذا كنت تقدم أقل من 10 إلى 15 طلبًا في الأسبوع، فستكون هناك لوحة فرعية لا تحتاج إليها بعد — ما عليك سوى استخدام لوحة تحكم Resimi مباشرة. عندما تجد نفسك تقضي أكثر من 30 دقيقة يوميًا في تقديم الطلب، فهذه إشارة للتشغيل التلقائي.