Đăng ký ngay

Tài liệu API BuffXin

API BuffXin cho bạn bán lại toàn bộ dịch vụ ngay trên panel hay website của mình. Tất cả gói trong một endpoint, phân nhánh bằng tham số action và luôn trả JSON, nên ghép vào hệ thống có sẵn gần như không phải đổi kiến trúc.

POST https://api.buffxin.com/api/v2

Khóa API và xác thực

Mọi lệnh gọi đều kèm một API key truyền qua tham số key. Bạn tạo và thu hồi key trong mục Tích hợp API trong tài khoản. Key chỉ hiện đầy đủ đúng một lần lúc tạo, hãy chép lại và cất nơi an toàn ngay.

Key gắn trực tiếp với tài khoản và ví của bạn. Khi bị thu hồi, key mất hiệu lực ngay lập tức.

Nguyên tắc gọi API

  • Phương thức: POST.
  • Định dạng: phản hồi luôn là JSON.
  • Lỗi: trả về { "error": "..." }. Luôn kiểm tra trường error trước khi xử lý.
  • Đơn giá (rate): là giá cho một đơn vị (1 like, 1 follow), tính theo VND.
  • Tiền tệ: VND.
  • Idempotency: thêm idempotency_key khi add để chống tạo trùng nếu phải gửi lại.
  • Giới hạn tần suất: gửi quá nhanh sẽ nhận lỗi giới hạn.

POST Danh mục dịch vụ services

Lấy về danh mục đang mở bán, mỗi mục kèm đơn giá, khoảng số lượng cho phép và thông tin bảo hành.

Tham số

Tham sốBắt buộcMô tả
keyAPI key của bạn
actionservices

Ví dụ

curl https://api.buffxin.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=services

Phản hồi

[
  {
    "service": "a1b2c3d4-5e6f-7890-abcd-ef1234567890",
    "name": "TikTok Followers",
    "category": "Followers",
    "rate": "30.0000000",
    "min": 10,
    "max": 100000,
    "refill": true,
    "cancel": false
  }
]

POST Kiểm tra số dư balance

Tham số

Tham sốBắt buộcMô tả
keyAPI key của bạn
actionbalance

Phản hồi

{ "balance": "1500000.0000", "currency": "VND" }

POST Đặt đơn add

Đặt một đơn mới. Đơn vào hàng đợi và chạy tự động, tiền trừ thẳng từ ví của bạn.

Tham số

Tham sốBắt buộcMô tả
keyAPI key của bạn
actionadd
serviceID dịch vụ (từ services)
linkLink công khai cần tăng tương tác
quantitySố lượng (trong khoảng min và max)
idempotency_keyKhôngChuỗi tùy chọn chống tạo trùng khi gửi lại

Ví dụ

curl https://api.buffxin.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=a1b2c3d4-5e6f-7890-abcd-ef1234567890 \
  -d link=https://www.tiktok.com/@user/video/123 \
  -d quantity=1000

Phản hồi

{ "order": "BX-AB12CD" }

Gửi lại cùng một idempotency_key thì hệ thống trả về đúng đơn đã tạo trước đó, không nhân đôi đơn.

POST Tra cứu đơn status

Kiểm tra tiến độ đơn: dùng order cho một mã, hoặc orders để tra nhiều đơn một lần (các mã cách nhau bằng dấu phẩy).

Tham số

Tham sốBắt buộcMô tả
keyAPI key của bạn
actionstatus
orderCó*Mã đơn (vd BX-AB12CD)
ordersCó*Nhiều mã đơn, cách nhau bằng dấu phẩy

* Dùng order cho một đơn, hoặc orders cho nhiều đơn.

Phản hồi (một đơn)

{
  "charge": "30000.0000",
  "start_count": 1200,
  "status": "In progress",
  "remains": 400,
  "currency": "VND"
}

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

statusÝ nghĩa
PendingĐã nhận đơn, chưa bắt đầu
In progressĐang giao
ProcessingĐang xử lý
CompletedHoàn tất
PartialGiao một phần (phần còn lại được hoàn)
CanceledĐã hủy / hoàn tiền

Hai action refillcancel đang được hoàn thiện, sẽ mở trong bản cập nhật tới.

Xử lý lỗi

errorNguyên nhân
Incorrect API keyKey sai, bị thu hồi, hoặc không đúng thương hiệu
Invalid actionaction không hợp lệ
Service not foundKhông tìm thấy dịch vụ
Service temporarily unavailableDịch vụ tạm thời không khả dụng
Invalid quantityquantity không phải số hợp lệ
Quantity must be between …Số lượng ngoài khoảng cho phép
Link is requiredThiếu link
Insufficient balanceSố dư không đủ để tạo đơn
Incorrect order IDMã đơn không tồn tại hoặc không thuộc tài khoản
Rate limit exceeded, slow downGửi quá nhanh

Ví dụ tích hợp

Cùng một luồng cơ bản (lấy danh mục → đặt đơn → kiểm tra trạng thái) viết sẵn cho vài ngôn ngữ hay dùng. Sao chép rồi thay YOUR_API_KEY bằng key của bạn.

# Danh sách dịch vụ
curl https://api.buffxin.com/api/v2 -d key=YOUR_API_KEY -d action=services

# Tạo đơn
curl https://api.buffxin.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=add \
  -d service=a1b2c3d4-5e6f-7890-abcd-ef1234567890 \
  -d link=https://www.tiktok.com/@user/video/123 \
  -d quantity=1000

# Trạng thái đơn
curl https://api.buffxin.com/api/v2 -d key=YOUR_API_KEY -d action=status -d order=BX-AB12CD