واجهة API للوحة SMM | إضافة الطلبات والتحقق من الحالة وإعادة التعبئة والإلغاء

مفتاح API واحد لكل خدمة في الكتالوج. بلا إجراءات موافقة وبلا "شريحة مطورين" منفصلة، فكل حساب يحصل على وصول API عند التسجيل.

واجهة API للموزّعين في هذه اللوحة هي نفسها التي يمر بها كل طلب في لوحة التحكم داخليًا، فلا توجد نسخة أضيق منها لمستخدمي API. تتبع شكل الطلب نفسه الذي تستخدمه معظم لوحات SMM (نقطة اتصال POST واحدة ومعامل "action" يحدد العملية)، فتحتاج التكاملات المبنية للوحة أخرى عادةً إلى تغيير الرابط الأساسي ومفتاح API فقط لتشير إلى هنا.

655

خدمة قابلة للاستدعاء

133

فئة

45

عملة

مسار التكامل

من موقعك إلى التسليم، في طلب واحد

شاهد ما يحدث حين يطلب عميل على موقعك: يستدعي نظامك API، ويُتحقَّق من الطلب، ويعود رقم الطلب، ثم يذهب الطلب إلى الخادم الذي يسلّمه.

  1. استلام الطلب. عميل يقدّم طلبًا على موقعك.
  2. إرسال الطلب. يرسل خادمك طلب POST واحدًا إلى API مع الخدمة والرابط والكمية.
  3. التحقق. تفحص API المفتاح ورصيدك والخدمة والرابط.
  4. الاستجابة. تتلقى استجابة JSON برقم الطلب. يمكن لموقعك تأكيد الطلب فورًا.
  5. الإرسال إلى الخادم. يُمرَّر الطلب إلى الخادم الذي يسلّم الخدمة.
  6. جارٍ التسليم. يبدأ التسليم وتنتقل الحالة من قيد الانتظار إلى قيد التنفيذ.
  7. مكتمل. تم. يمكنك التحقق من الحالة في أي وقت بإجراء status.

الطلب

POST

POST /api/v2

key=••••••••••••

action=add

service=124

link=https://instagram.com/p/example

quantity=1000

استجابة JSON

200

HTTP 200 OK

{

"order": 23501

}

الطريقة

POST

الصيغة

JSON

حد دفعة الحالة

100 معرّف طلب

الإصدار

API v2

رسم توضيحي. أرقام الطلبات والكميات أمثلة.

الإجراءات المتاحة

services سرد كل الخدمات النشطة وأسعارها وحدّيها الأدنى والأقصى وفئتها.
add تقديم طلب: رقم الخدمة والرابط والكمية.
status التحقق من حالة طلب أو أكثر والعدد المتبقي والعدد الابتدائي في استدعاء واحد.
refill طلب إعادة تعبئة لطلب تدعمها خدمته.
refill_status التحقق من حالة إعادة تعبئة طُلبت سابقًا.
cancel إلغاء طلب لا يزال في حالة قابلة للإلغاء.
balance إرجاع رصيد المحفظة الحالي وعملته.

لماذا تبني على هذه API

بلا شريحة منفصلة

API ليست إضافة مدفوعة ولا ميزة مرهونة بموافقة، فكل حساب يحصل على مفتاح عند التسجيل، ويصل إلى الكتالوج والأسعار نفسها التي تعرضها لوحة التحكم.

استدعاء واحد لعدة طلبات

يقبل إجراء status عدة معرّفات طلبات دفعة واحدة، فلا يحتاج بوت أو متجر يتابع دفعة من الطلبات إلى طلب منفصل لكل طلب.

شكل طلب مألوف

نقطة اتصال واحدة مع معامل action هو النمط نفسه الذي تستخدمه معظم واجهات SMM للموزّعين، فالأدوات المبنية لوحة أخرى تبعد عادةً تغيير إعداد واحد عن العمل هنا.

تتبع صحة المزوّدين

تُراقَب نسبة نجاح الاستدعاءات الأخيرة لكل مزوّد، فتُكتشف مشكلة المزوّد بسرعة بدل إفشال الطلبات بصمت لأيام.

البداية

  1. 1 أنشئ حسابًا مجانيًا، لا خطوة موافقة، ويصدر مفتاح API فورًا.
  2. 2 انسخ مفتاح API من لوحة التحكم.
  3. 3 استدعِ إجراء services لجلب الكتالوج الحالي والأسعار وأرقام الخدمات.
  4. 4 استدعِ add برقم خدمة ورابط وكمية لتقديم أول طلب.
عرض توثيق API كاملًا

الأسئلة الشائعة

نعم، يحصل كل حساب على مفتاح API مجانًا عند التسجيل، دون طلب منفصل أو خطوة موافقة.
نعم، الخدمات نفسها والأسعار نفسها وتُحدَّث بالطريقة نفسها، فلا يوجد كتالوج "API فقط" مخفَّض.
نعم، يقبل إجراء status قائمة معرّفات طلبات مفصولة بفواصل ويُرجعها كلها في استجابة واحدة.
تُراقَب نسب نجاح استدعاءات المزوّدين، فتُكتشف المشكلة بسرعة، ويمكن من جهة الإدارة توجيه خدمة متأثرة إلى مزوّد آخر. وهذا ليس فوريًا ولا تلقائيًا أثناء تنفيذ الطلب.
راجع توثيق API الكامل لحدود الطلبات الحالية واستجابات الأخطاء.
المزيد من الأسئلة؟ اطّلع على الأسئلة الشائعة كاملة

مستعد لتقديم أول طلب؟

إنشاء الحساب مجاني ويستغرق أقل من دقيقة. يُصدَر مفتاح API الخاص بك فورًا.