LogoLogo
Quay lại

Tài liệu API

API Followir SMM Panel v2: endpoint, tham số, ví dụ yêu cầu và phản hồi.

Followir cung cấp một API HTTP đơn giản theo định dạng phổ biến SMM Panel API v2, nên hầu hết các panel đại lý và script đều hoạt động với nó mà không cần chỉnh sửa. Mọi phản hồi đều là JSON.

Bắt đầu

  1. Tạo tài khoản và nạp tiền.
  2. Mở trang API trong tài khoản của bạn và tạo khóa API. Hãy giữ bí mật khóa này.
  3. Tùy chọn: thêm các địa chỉ IP được phép dùng khóa của bạn (để trống để cho phép mọi IP).

Endpoint

URLhttps://followir.com/api/v2
Phương thứcPOST (GET cũng được)
Định dạngTham số dạng form đầu vào, JSON đầu ra
Bắt buộc trong mọi lệnh gọikey (khóa API của bạn) và action

Các action

actionTham sốChức năng
serviceskeyLiệt kê tất cả dịch vụ khả dụng kèm giá và giới hạn
addkey, service, link, quantity (runs, interval cho drip-feed)Tạo đơn hàng mới
statuskey, order hoặc orders (phân tách bằng dấu phẩy)Trạng thái đơn hàng, một hoặc nhiều đơn
cancelkey, order or orders (comma separated)Hủy đơn hàng của các dịch vụ cho phép hủy
refillkey, order or orders (comma separated)Yêu cầu refill cho các đơn hàng đủ điều kiện
refill_statuskey, refillTrạng thái của yêu cầu refill
balancekeySố dư và đơn vị tiền tệ hiện tại của bạn

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 là giá mỗi 1000. refill và cancel cho biết dịch vụ có hỗ trợ hay không.

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 }

Với các dịch vụ drip-feed, bạn cũng có thể gửi runs (ít nhất 2) và interval (phút, từ 1 đến 1440). Các dịch vụ khác sẽ bỏ qua chúng.

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

Nhiều đơn cùng lúc: gửi orders=850758,850759. Phản hồi là một object với khóa là mã đơn hàng. Các giá trị status có thể có: 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" }

Một số yêu cầu hủy phải chờ xác nhận, khi đó phản hồi hiển thị "status": "Pending". Với nhiều đơn, bạn nhận được danh sách các mục { "order": ..., "cancel": ... } items.

refill và 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" }

Lỗi

Khi có sự cố, phản hồi sẽ có trường error:

{ "error": "Not enough funds" }
Thông báoÝ nghĩa
API key is requiredThiếu tham số key
Action is required / Incorrect actionaction bị thiếu hoặc không xác định
Invalid API keyKhóa sai, đã bị tắt, hoặc IP của bạn không nằm trong danh sách được phép
Incorrect service ID / Service not foundMã dịch vụ không tồn tại hoặc đã bị tắt
Link is required / Incorrect quantityThiếu liên kết, hoặc số lượng không phải là số hợp lệ
Quantity must be between ...Nằm ngoài mức tối thiểu và tối đa của dịch vụ
Not enough fundsSố dư của bạn quá thấp cho đơn hàng này
Order not foundĐơn hàng không tồn tại trong tài khoản của bạn
Cancel is not available for this serviceDịch vụ này không thể hủy

Ví dụ mã

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())

Cần biết

  • Mã đơn hàng giống với mã bạn thấy ở trang đơn hàng.
  • Đặt nhiều đơn cho cùng một liên kết cùng lúc có thể bị từ chối cho đến khi đơn đầu tiên hoàn tất.
  • Mọi lệnh gọi đều được ghi lại trên tài khoản của bạn. Nếu bạn nghĩ khóa của mình bị lộ, hãy tạo lại từ trang API.
  • Cần hỗ trợ tích hợp? Hãy mở ticket trên trang hỗ trợ.

Quay lại