Tài liệu API V2

REST API cho reseller / bot. Trừ tiền ví, xác thực bằng X-API-Key.

Đấu nối trong 5 bước

  1. Nạp tiền vào ví (API trừ tiền ví, không có cổng thanh toán riêng).
  2. Tạo API key tại Thông tin cá nhân, gửi mọi request với header X-API-Key.
  3. GET /v1/services — lấy field id, dùng làm serviceId khi tạo đơn.
  4. POST /v1/orders — gửi serviceId + field phụ của đúng loại dịch vụ.
  5. Lưu orderCode trong response, dùng GET /v1/orders/:orderCode để theo dõi.

Thông tin chung

  • Base URL: https://api.sub247.net/v1
  • Xác thực: header X-API-Key: YOUR_KEY
  • Thành công: { "data": ..., "message": "" } — payload nằm trong data
  • Lỗi: { "statusCode": 400, "message": "..." } — message là string hoặc mảng
  • Rate limit: 100 request / phút / API key
  • Không gửi field lạ (kể cả serviceType khi tạo đơn).

Danh sách endpoint

GET/v1/balanceSố dư ví hiện tại
GET/v1/servicesDanh sách dịch vụ (?serviceType=)
POST/v1/ordersTạo đơn
GET/v1/ordersDanh sách đơn (page, pageSize, status, serviceType)
GET/v1/orders/:orderCodeChi tiết / trạng thái đơn
POST/v1/orders/:orderCode/buff-cancelYêu cầu hủy đơn buff
POST/v1/orders/:orderCode/buff-refillYêu cầu bảo hành đơn buff

Ví dụ nhanh (curl)

curl -H "X-API-Key: YOUR_KEY" https://api.sub247.net/v1/balance