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_status`	key, 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 भेजें। जवाब एक ऑब्जेक्ट होता है जिसकी Key ऑर्डर नंबर होती है। 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" }

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 पेज से दोबारा बनाएँ।
इंटीग्रेट करने में मदद चाहिए? सपोर्ट पेज पर टिकट खोलें।