وثائق واجهة برمجة التطبيقات (API)

توفر Followir واجهة برمجة تطبيقات HTTP بسيطة تتبع التنسيق الشائع SMM Panel API v2، لذا تعمل معظم لوحات الموزعين والبرامج النصية معها كما هي. جميع الردود بتنسيق JSON.

البدء

1. أنشئ حسابًا وأضف رصيدًا.
2. افتح صفحة واجهة برمجة التطبيقات في حسابك وقم بإنشاء مفتاح واجهة برمجة التطبيقات الخاص بك. احرص على سرية هذا المفتاح.
3. اختياري: أضف عناوين IP المسموح لها باستخدام مفتاحك (اترك الحقل فارغًا للسماح بأي عنوان IP).

نقطة النهاية

عنوان URL	https://followir.com/api/v2
الطريقة	POST (تعمل طريقة GET أيضًا)
التنسيق	معلمات النموذج في، JSON في المخرجات
مطلوب في كل استدعاء	key (مفتاح API الخاص بك) و action

الإجراءات

services

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=services"

[
  {
    "service": "1",
    "name": "متابعو إنستغرام",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.9000",
    "min": "100",
    "max": "100000",
    "refill": true,
    "cancel": false
  }
]

rate هو السعر لكل 1000. refill و cancel يوضحان ما إذا كانت الخدمة تدعمهما أم لا.

add

curl -X POST "https://followir.com/api/v2" \
  -d "key=YOUR_API_KEY" -d "action=add" \
  -d "service=1" -d "link=https://instagram.com/username" -d "quantity=1000"

{ "order": 850758 }

بالنسبة لخدمات التغذية التدريجية، يمكنك أيضًا إرسال عدد مرات التشغيل (2 على الأقل) والفاصل الزمني (بالدقائق، من 1 إلى 1440). يتم تجاهل هذه المعلمات في الخدمات الأخرى.

الحالة

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=status" -d "order=850758"

{
  "charge": "0.9000",
  "start_count": "3572",
  "status": "قيد التنفيذ",
  "remains": "400",
  "currency": "USD"
}

عدة طلبات في آن واحد: أرسل orders=850758,850759. الرد عبارة عن كائن يتم تحديد مفتاحه برقم الطلب. القيم المحتملة لـ status: Pending، In progress، Completed، Partial، Canceled، Refunded.

cancel

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=cancel" -d "order=850758"

{ "status": "Success" }

تنتظر بعض عمليات الإلغاء التأكيد، ثم يظهر الرد "status": "Pending". مع وجود عدة طلبات، تحصل على قائمة من العناصر { "order": ..., "cancel": ... }.

refill و refill_status

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill" -d "order=850758"
{ "refill": "12" }

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill_status" -d "refill=12"
{ "refill": "12", "status": "Pending" }

الرصيد

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=balance"

{ "balance": "25.50", "currency": "USD" }

الأخطاء

عندما يحدث خطأ ما، تحتوي الردود على حقل error:

{ "error": "Not enough funds" }

أمثلة على الأكواد

PHP

$ch = curl_init("https://followir.com/api/v2");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key'    => 'YOUR_API_KEY',
    'action' => 'add',
    'service'  => 1,
    'link'     => 'https://instagram.com/username',
    'quantity' => 1000,
]));
$response = json_decode(curl_exec($ch), true);
print_r($response);

Python

استيراد requests

r = requests.post("https://followir.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": 850758,
})
print(r.json())

معلومات مفيدة

• أرقام الطلبات هي نفسها التي تراها في صفحة الطلبات الخاصة بك.
• قد يتم رفض تقديم العديد من الطلبات لنفس الرابط في وقت واحد حتى يتم الانتهاء من الطلب الأول.
• يتم تسجيل كل استدعاء في حسابك. إذا كنت تعتقد أن مفتاحك قد تسرب، فقم بإعادة إنشائه من صفحة API.
• هل تحتاج إلى مساعدة في عملية الدمج؟ افتح تذكرة على صفحة الدعم.