Tài liệu API

Phiên bản API: v2

FoxiGrow cung cấp API SMM Panel tiêu chuẩn cho phép bạn tích hợp dịch vụ của chúng tôi vào ứng dụng của riêng bạn. Tài liệu này bao gồm tất cả các endpoint có sẵn và cách sử dụng chúng.

Endpoint API

https://foxigrow.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

Tất cả các yêu cầu API đều yêu cầu xác thực bằng khóa API của bạn. Bạn có thể tìm thấy khóa API trong cài đặt tài khoản. Bao gồm tham số key trong mỗi yêu cầu.

POST https://foxigrow.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ờ

Hỗ trợ

Nếu bạn có bất kỳ câu hỏi nào về API, vui lòng liên hệ đội ngũ hỗ trợ của chúng tôi:

Telegram: @FoxigrowBD