Proxy Service Logo

Tài liệu API Proxy

Hướng dẫn đầy đủ để tích hợp và sử dụng API Proxy HD FutureTech

Nội dung

Giới thiệu

HD FutureTech cung cấp API Proxy cho phép bạn tích hợp dịch vụ proxy vào hệ thống của mình một cách dễ dàng và hiệu quả. Tài liệu này hướng dẫn chi tiết về cách sử dụng API của chúng tôi.

Tổng quan tính năng

  • Xem số dư
  • Xem tất cả proxy đang hoạt động

Bắt đầu nhanh

Để bắt đầu sử dụng API của chúng tôi, bạn cần có một tài khoản HD FutureTech và token API. Các API endpoint của chúng tôi được xây dựng theo chuẩn RESTful và sử dụng định dạng JSON.

URL cơ sở

https://api.hdfuturetech.com

Xác thực

Tất cả các API của chúng tôi yêu cầu xác thực bằng token API. Để lấy token, hãy đăng nhập vào tài khoản HD FutureTech và tạo token từ trang quản lý API tokens.

Thêm token vào Header

Thêm token vào header Authorization của mỗi request:

Header Authorization

Authorization: Bearer hd_ft_api_your_token_here

Lưu ý quan trọng

  • Token sẽ hết hạn sau thời gian chỉ định khi tạo
  • Bảo vệ token của bạn, không chia sẻ với người không liên quan
  • Có thể vô hiệu hóa token từ trang quản lý token bất cứ lúc nào
  • Gửi token trong header chứ không phải trong URL hoặc body request
POST

Đổi IP Proxy V2

API này dùng để đổi IP proxy xoay v2 bằng API Token. User có thể truyền keyxoay hoặcidDetailBuyProxyRotateKey.

Endpoint URL

/api/v1/user/buy-proxy/change-proxy-rotate-v2

Header xác thực

Authorization: Bearer hd_ft_api_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Request body

Frontend có thể truyền một trong 2 cách:

1. Dùng keyxoay

{
  "keyxoay": "103.170.254.252:8825:M0rDdIclthanh:XhnKwzUa",
  "location": "Random"
}

2. Dùng idDetailBuyProxyRotateKey

{
  "idDetailBuyProxyRotateKey": "69cd0d6d6713bf310848cbd7",
  "location": "Random"
}
  • location là optional.
  • Nếu không truyền location, backend dùng mặc định Random.

Response thành công

{
  "success": true,
  "message": "Thay đổi IP proxy thành công",
  "data": {
    "idDetailBuyProxyRotateKey": "69cd0d6d6713bf310848cbd7",
    "keyxoay": "103.170.254.252:8825:M0rDdIclthanh:XhnKwzUa",
    "proxy": {
      "hostIp": "103.170.254.252",
      "port": "8825",
      "username": "M0rDdIclthanh",
      "password": "XhnKwzUa"
    },
    "expiredAt": "2026-04-02T12:19:57.000Z",
    "nextChangeAfterSeconds": 240
  }
}
keyxoay: key hiện tại của proxy sau khi đổi IP.
proxy.hostIp / proxy.port: IP và port hiện tại dùng để kết nối.
proxy.username / proxy.password: thông tin xác thực của proxy.
expiredAt / nextChangeAfterSeconds: hạn sử dụng và thời gian tối thiểu trước lần đổi IP tiếp theo.

Response khi chưa đến thời gian đổi IP

{
  "success": false,
  "message": "Proxy đang trong thời gian chờ đổi IP, vui lòng thử lại sau 209 giây",
  "keyxoay": "103.170.254.252:8825:M0rDdIclthanh:XhnKwzUa",
  "idDetailBuyProxyRotateKey": "69cd0d6d6713bf310848cbd7",
  "retryAfterSeconds": 209
}

Frontend nên xử lý:

  • Nếu có retryAfterSeconds, hãy khóa nút đổi IP.
  • Hiển thị countdown theo số giây này.
  • Hết countdown thì cho user bấm lại.

Response lỗi thường gặp

{
  "success": false,
  "message": "Không tìm thấy proxy hoặc bạn không có quyền truy cập"
}
  • 401: token không hợp lệ hoặc thiếu token.
  • 404: keyxoay hoặc idDetailBuyProxyRotateKey không thuộc user của API token.
  • 400: proxy hết hạn hoặc đang trong thời gian chờ đổi IP.

Curl mẫu

Theo keyxoay

curl --location 'https://api.hdfuturetech.com/api/v1/user/buy-proxy/change-proxy-rotate-v2' \
--header 'Authorization: Bearer hd_ft_api_xxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{"keyxoay":"103.170.254.252:8825:M0rDdIclthanh:XhnKwzUa","location":"Random"}'

Theo idDetailBuyProxyRotateKey

curl --location 'https://api.hdfuturetech.com/api/v1/user/buy-proxy/change-proxy-rotate-v2' \
--header 'Authorization: Bearer hd_ft_api_xxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data '{"idDetailBuyProxyRotateKey":"69cd0d6d6713bf310848cbd7","location":"Random"}'

Axios mẫu

import axios from "axios";

const api = axios.create({
  baseURL: "https://api.hdfuturetech.com",
});

export const changeProxyRotateV2 = async (
  apiToken: string,
  payload:
    | { keyxoay: string; location?: string }
    | { idDetailBuyProxyRotateKey: string; location?: string }
) => {
  const { data } = await api.post(
    "/api/v1/user/buy-proxy/change-proxy-rotate-v2",
    payload,
    {
      headers: {
        Authorization: `Bearer ${apiToken}`,
      },
    }
  );

  return data;
};
GET

Lấy Proxy đang hoạt động

Lấy danh sách Proxy đang hoạt động tới thời điểm hiện tại .

Endpoint URL

/api/v1/user/buy-proxy/get-list-proxy-live

Ví dụ code

const axios = require('axios');

const getProxy = async () => {
  try {
    const response = await axios.post('https://api.hdfuturetech.com/api/v1/user/buy-proxy/get-list-proxy-live?typeProxy=ipv4', {
    }, {
      headers: {
        'Authorization': 'Bearer hd_ft_api_your_token_here',
        'Content-Type': 'application/json'
      }
    });
    
    console.log('Proxy:', response.data);
    return response.data;
  } catch (error) {
    console.error('Lỗi khi lấy proxy:', error.response?.data || error.message);
    throw error;
  }
};

getProxy();

Phản hồi

Thành công (200)

{
  "success": true,
  "data": {
    "status": 200,
    "data": [
      {
        "_id": "6844fa4bae27d2951adeaf48",
        "orderId": "",
        "proxy": "180.149.35.204:28494:hdfuturetech:hdfuturetech",
        "type": "HTTP",
        "timeExpired": "2025-06-09T02:49:57.000Z"
      }
    ],
    "message": "Success"
  }
}

Lỗi (404)

{
  "success": false,
  "message": "Chỉ hỗ trợ ipv4 , ipv6 & rotate"
}
GET

Lấy thông tin số dư

Lấy thông tin số dư hiện có

Endpoint URL

/api/v1/user/buy-proxy/get-balance-account

Phản hồi

Thành công (200)

{
  "status": 200,
  "message": "success",
  "data": {
    "username": "your username",
    "email": "yourEmail@gmail.com",
    "status": "active",
    "balance": 0
  }
}

Lỗi (400)

{
  "success": false,
  "message": "Không tồn tại user này !",
  "data": null
}

Tạo Key Ngay

Dưới đây là hướng dẫn nhanh để tạo và sử dụng key proxy xoay trong vài phút.

1

Đăng ký & Nạp tiền

Đăng ký tài khoản HD FutureTech và nạp tiền vào tài khoản của bạn.

Đăng ký ngay →
2

Tạo API Token

Tạo token API từ trang cài đặt tài khoản để xác thực các yêu cầu API của bạn.

Tạo Token →
3

Mua Key & Sử dụng

Sử dụng API để mua key proxy xoay và tích hợp vào ứng dụng của bạn.

Xem hướng dẫn →

Cần hỗ trợ nhanh?

Đội ngũ hỗ trợ kỹ thuật của chúng tôi luôn sẵn sàng giúp đỡ bạn tích hợp API proxy xoay vào hệ thống của bạn.

Sẵn sàng trải nghiệm?

Bắt đầu sử dụng API proxy của HD FutureTech ngay hôm nay

HDSoftware Logo