Trên trang này

Tài liệu API Panel SMM

Phiên bản API: v2

SmmFoxi cung cấp API Panel SMM tiêu chuẩn (v2) để bạn tích hợp 373 dịch vụ tiếp thị mạng xã hội trực tiếp vào panel đại lý, bot hoặc ứng dụng của bạn. Khởi động nhanh với dịch vụ đủ điều kiện, giá cạnh tranh và tự động hóa hoàn toàn. Tài liệu này bao gồm tất cả endpoint có sẵn và cách sử dụng.

Trước khi bắt đầu: mở quyền truy cập API trong 4 bước

Trước lệnh gọi đầu tiên, bạn cần một tài khoản, số dư và một API key. Chỉ mất vài phút để thiết lập:

  1. 1

    Tạo tài khoản

    Đăng ký tài khoản SmmFoxi. Cùng một tài khoản dùng cho bảng điều khiển web và API.

    Đăng ký →
  2. 2

    Nạp số dư

    Đơn hàng qua API được trừ vào số dư tài khoản. Nạp tiền trong bảng điều khiển; bạn có thể kiểm tra số dư bất cứ lúc nào bằng action=balance.

    Mở bảng điều khiển →
  3. 3

    Lấy API key

    Vào Bảng điều khiển → API và tạo key. Key đầy đủ chỉ hiển thị một lần — hãy sao chép và lưu giữ an toàn. Làm mới key sẽ vô hiệu hóa key cũ ngay lập tức.

    Lấy API key →
  4. 4

    Tích hợp và thử nghiệm

    Gửi yêu cầu POST tới địa chỉ bên dưới kèm key và một action. Bắt đầu với action=services để lấy ID và giá dịch vụ, sau đó đặt một đơn thử nhỏ.

    Xem địa chỉ →

Endpoint API

https://smmfoxi.com/api/v2

Tất cả các yêu cầu phải được gửi đến endpoint này qua phương thức POST hoặc GET.

Xác thực

Mọi yêu cầu API đều cần xác thực bằng API key của bạn. Tạo key tại Bảng điều khiển → API (key đầy đủ chỉ hiển thị một lần, hãy lưu lại ngay). Gửi kèm tham số key trong mỗi yêu cầu.

POST https://smmfoxi.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Định dạng phản hồi

Tất cả các phản hồi được trả về dưới định dạng JSON. Các yêu cầu thành công trả về dữ liệu được yêu cầu, trong khi lỗi trả về đối tượng với mô tả.

Các Endpoint API

Lấy danh sách dịch vụ

Trả về danh sách tất cả các dịch vụ có sẵn với chi tiết bao gồm giá, số lượng tối thiểu và tối đa.

Tham số

  • key - Khóa API của bạn (bắt buộc)
  • action - "services"
// Ví dụ phản hồi
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Lấy số dư

Trả về số dư tài khoản hiện tại và loại tiền tệ của bạn.

Tham số

  • key - Khóa API của bạn (bắt buộc)
  • action - "balance"
// Ví dụ phản hồi
{
  "balance": "100.84292",
  "currency": "USD"
}

Thêm đơn hàng

Tạo đơn hàng mới cho một dịch vụ. Các tham số bắt buộc phụ thuộc vào loại dịch vụ.

Loại mặc định

  • key - Khóa API của bạn (bắt buộc)
  • action - "add"
  • service - ID dịch vụ (bắt buộc)
  • link - URL đích (bắt buộc)
  • quantity - Số lượng đơn hàng (bắt buộc)

Loại gói

  • key - Khóa API của bạn (bắt buộc)
  • action - "add"
  • service - ID dịch vụ (bắt buộc)
  • link - URL đích (bắt buộc)

Loại bình luận tùy chỉnh

  • key - Khóa API của bạn (bắt buộc)
  • action - "add"
  • service - ID dịch vụ (bắt buộc)
  • link - URL đích (bắt buộc)
  • comments - Bình luận phân cách bằng dòng mới (bắt buộc)
// Ví dụ phản hồi
{
  "order": 23501
}

Trạng thái đơn hàng

Lấy trạng thái của một hoặc nhiều đơn hàng. Bạn có thể truy vấn một đơn hàng hoặc nhiều đơn hàng cùng lúc.

Đơn hàng đơn

  • key - Khóa API của bạn (bắt buộc)
  • action - "status"
  • order - ID đơn hàng (bắt buộc)

Nhiều đơn hàng (tối đa 100)

  • key - Khóa API của bạn (bắt buộc)
  • action - "status"
  • orders - Các ID đơn hàng phân cách bằng dấu phẩy (bắt buộc)
// Ví dụ phản hồi
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Tạo bổ sung

Yêu cầu bổ sung cho một đơn hàng. Chỉ khả dụng cho các dịch vụ hỗ trợ bổ sung.

Tham số

  • key - Khóa API của bạn (bắt buộc)
  • action - "refill"
  • order - ID đơn hàng (bắt buộc)
// Ví dụ phản hồi
{
  "refill": "1"
}

Trạng thái bổ sung

Kiểm tra trạng thái của yêu cầu bổ sung.

Tham số

  • key - Khóa API của bạn (bắt buộc)
  • action - "refill_status"
  • refill - ID bổ sung (bắt buộc)
// Ví dụ phản hồi
{
  "status": "Completed"
}

Các trạng thái đơn hàng

  • Pending - Đơn hàng đang chờ xử lý
  • Processing - Đơn hàng đang được chuẩn bị
  • In progress - Đơn hàng đang chạy
  • Completed - Đơn hàng đã hoàn thành thành công
  • Partial - Đơn hàng hoàn thành một phần (hoàn tiền phần còn lại)
  • Canceled - Đơn hàng đã bị hủy

Xử lý lỗi

Khi xảy ra lỗi, API trả về đối tượng JSON với trường error mô tả vấn đề.

// Ví dụ phản hồi lỗi
{
  "error": "Invalid API key"
}

Giới hạn tốc độ

Để đảm bảo chất lượng dịch vụ, các giới hạn tốc độ sau được áp dụng:

  • 5 yêu cầu mỗi giây
  • 100 yêu cầu mỗi phút
  • 1000 yêu cầu mỗi giờ