Tích hợp API

Tích hợp toàn bộ danh mục dịch vụ SMM của BuffXịn vào hệ thống của bạn. Một endpoint duy nhất, gọi bằng tham số action, trả về JSON. Tương thích với hầu hết hệ thống có sẵn.

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

↓ Tải Postman collection

Xác thực

Mỗi yêu cầu cần một API key, gửi qua tham số key. Tạo và quản lý key tại Tích hợp API trong tài khoản. Key chỉ hiển thị một lần khi tạo, nên lưu lại nơi an toàn.

Mỗi key gắn với tài khoản và số dư của bạn. Key bị thu hồi sẽ ngừng hoạt động ngay lập tức.

Quy ước chung

  • 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 sách dịch vụ services

Trả về tất cả dịch vụ đang bán, kèm đơn giá và giới hạn số lượng.

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 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ạo đơn add

Tạo đơn và tự động xử lý, trừ vào số dư 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": "LK-AB12CD" }

Gửi lại cùng một idempotency_key sẽ trả về đơn cũ thay vì tạo đơn trùng.

POST Trạng thái đơn status

Tra cứu một đơn qua order, hoặc nhiều đơn cùng lúc bằng orders (các ID 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 LK-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"
}

Giá trị trạng thái

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

refillcancel sẽ được bổ sung trong bản cập nhật tới.

Mã lỗi thường gặp

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 hết nguồn cung
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ụ theo ngôn ngữ

Cùng một luồng (danh sách dịch vụ → tạo đơn → trạng thái) trong các ngôn ngữ phổ biến. Sao chép và thay YOUR_API_KEY.

# 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=LK-AB12CD