Trang chủ › Tài liệu API

API cho đại lý và công cụ riêng

API của BuffViet theo chuẩn Perfect Panel — chuẩn mà hầu hết panel trên thị trường dùng. Nếu bạn đã có công cụ chạy với panel khác, chỉ cần đổi địa chỉ và khoá là chạy tiếp, không phải viết lại gì.

Thông tin chung

• Địa chỉ: https://13.140.81.106.nip.io/api/v2
• Phương thức: POST, dữ liệu dạng form hoặc JSON
• Khoá API lấy trong Tài khoản; mỗi tài khoản một khoá
• Đơn vị tiền: VND. Giá tính trên 1.000 đơn vị

Lấy danh mục dịch vụ

curl -X POST https://13.140.81.106.nip.io/api/v2 \
  -d "key=KHOA_CUA_BAN" -d "action=services"

Trả về danh sách gói, mỗi gói có service (mã để đặt đơn), rate (giá/1000), min, max, refill (có bảo hành không), dripfeed (chia nhỏ đơn được không).

Đặt đơn

curl -X POST https://13.140.81.106.nip.io/api/v2 \
  -d "key=KHOA_CUA_BAN" -d "action=add" \
  -d "service=123" -d "link=https://www.tiktok.com/@abc/video/123" -d "quantity=1000"

Trả về {{"order": 1234}}. Chia nhỏ đơn thì thêm runs và interval (phút). Tiền trừ thẳng từ ví; thiếu tiền thì trả lỗi và không tạo đơn.

Kiểm tra đơn

curl -X POST https://13.140.81.106.nip.io/api/v2 -d "key=KHOA_CUA_BAN" -d "action=status" -d "order=1234"
curl -X POST https://13.140.81.106.nip.io/api/v2 -d "key=KHOA_CUA_BAN" -d "action=multi-status" -d "orders=1,2,3"

Trạng thái trả về theo từ vựng chuẩn: Pending, In progress, Completed, Partial, Canceled. remains là phần chưa giao; phần không giao đủ đã được hoàn về ví theo chính sách hoàn tiền.

Số dư và bảo hành

curl -X POST https://13.140.81.106.nip.io/api/v2 -d "key=KHOA_CUA_BAN" -d "action=balance"
curl -X POST https://13.140.81.106.nip.io/api/v2 -d "key=KHOA_CUA_BAN" -d "action=refill" -d "order=1234"

Giới hạn

Mỗi tài khoản đặt tối đa một số đơn nhất định trong vài phút để chống lỗi vòng lặp; vượt mức sẽ nhận {{"error": "Rate limit exceeded"}}. Khoá bị lộ thì vào Tài khoản cấp khoá mới — khoá cũ mất hiệu lực ngay.