API دستاویزات

Followir ایک سادہ HTTP API فراہم کرتا ہے جو عام SMM Panel API v2 فارمیٹ کی پیروی کرتی ہے، اس لیے زیادہ تر ری سیلر پینلز اور اسکرپٹس اس کے ساتھ جوں کے توں کام کرتے ہیں۔ تمام جوابات JSON میں ہوتے ہیں۔

شروع کرنا

اکاؤنٹ بنائیں اور فنڈز شامل کریں۔
اپنے اکاؤنٹ میں API صفحہ کھولیں اور اپنی API key بنائیں۔ اسے نجی رکھیں۔
اختیاری: وہ IP ایڈریسز شامل کریں جنہیں آپ کی key استعمال کرنے کی اجازت ہو (کسی بھی IP کو اجازت دینے کے لیے خالی چھوڑ دیں)۔

اینڈ پوائنٹ

URL	`https://followir.com/api/v2`
طریقہ	POST (GET بھی کام کرتا ہے)
فارمیٹ	اندر فارم پیرامیٹرز، باہر JSON
ہر کال میں لازمی	`key` (آپ کی API key) اور `action`

ایکشنز

action	پیرامیٹرز	یہ کیا کرتا ہے
`services`	key	قیمتوں اور حدود کے ساتھ تمام دستیاب سروسز کی فہرست
`add`	key, service, link, quantity (runs, interval for drip-feed)	نیا آرڈر دیں
`status`	key, order or orders (comma separated)	آرڈر کا اسٹیٹس، ایک یا کئی
`cancel`	key, order or orders (comma separated)	ان سروسز پر آرڈرز منسوخ کریں جو اجازت دیتی ہیں
`refill`	key, order or orders (comma separated)	اہل آرڈرز پر Refill کی درخواست کریں
`refill_status`	key, refill	Refill کی درخواست کا اسٹیٹس
`balance`	key	آپ کا موجودہ بیلنس اور کرنسی

services

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

[
  {
    "service": "1",
    "name": "Instagram Followers",
    "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 }

ڈرپ فیڈ سروسز کے لیے آپ runs (کم از کم 2) اور interval (منٹ، 1 سے 1440) بھی بھیج سکتے ہیں۔ دوسری سروسز پر انہیں نظر انداز کر دیا جاتا ہے۔

status

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": "In progress",
  "remains": "400",
  "currency": "USD"
}

ایک ساتھ کئی آرڈرز: orders=850758,850759 بھیجیں۔ جواب ایک آبجیکٹ ہوتا ہے جس کی keys آرڈر نمبرز ہوتی ہیں۔ 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 and 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" }

balance

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" }

پیغام	مطلب
`API key is required`	`key` پیرامیٹر موجود نہیں
`Action is required` / `Incorrect action`	`action` موجود نہیں یا نامعلوم ہے
`Invalid API key`	key غلط ہے، غیر فعال ہے، یا آپ کا IP وائٹ لسٹ میں نہیں ہے
`Incorrect service ID` / `Service not found`	سروس نمبر موجود نہیں یا غیر فعال ہے
`Link is required` / `Incorrect quantity`	لنک موجود نہیں، یا مقدار درست عدد نہیں ہے
`Quantity must be between ...`	سروس کی کم از کم اور زیادہ سے زیادہ حد سے باہر
`Not enough funds`	اس آرڈر کے لیے آپ کا بیلنس بہت کم ہے
`Order not found`	یہ آرڈر آپ کے اکاؤنٹ میں موجود نہیں
`Cancel is not available for this service`	یہ سروس منسوخ نہیں ہو سکتی

کوڈ کی مثالیں

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

import requests

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

جاننے کی باتیں

آرڈر نمبرز وہی ہیں جو آپ کو اپنے آرڈرز کے صفحے پر نظر آتے ہیں۔
ایک ہی لنک پر ایک ساتھ کئی آرڈرز دینے پر، پہلا مکمل ہونے تک، انہیں مسترد کیا جا سکتا ہے۔
ہر کال آپ کے اکاؤنٹ پر لاگ ہوتی ہے۔ اگر آپ کو لگے کہ آپ کی key لیک ہو گئی ہے تو اسے API صفحے سے دوبارہ بنائیں۔
انٹیگریشن میں مدد چاہیے؟ سپورٹ صفحے پر ٹکٹ کھولیں۔