Hướng dẫn này cho biết cách gia hạn (renew) các proxy bạn đang sở hữu qua API để giữ nguyên địa chỉ IP. Hãy gia hạn đúng hạn — khi proxy hết hạn, IP có thể bị mất.

Mỗi yêu cầu sử dụng khóa API cá nhân của bạn từ bảng điều khiển tài khoản (cách lấy khóa API). Trong các ví dụ dưới đây, hãy thay YOUR_API_KEY bằng khóa của bạn. Để thanh toán bằng số dư tài khoản, dùng paymentId = 1.

⚠️ Bước cuối trừ tiền từ số dư của bạn. Luôn kiểm tra chi phí ở bước tính toán trước.

Tổng quan quy trình

Tìm các proxy cần gia hạn và sao chép ID của chúng.
Chọn phương thức thanh toán (hoặc dùng số dư).
Tính chi phí gia hạn.
Thực hiện gia hạn.

Bước 1 — Tìm các proxy cần gia hạn

Liệt kê các proxy đang hoạt động và sao chép id của mỗi proxy bạn muốn gia hạn. Chỉ những proxy có can_prolong: true mới gia hạn được. Ghi lại loại proxy (ipv4, ipv6, mobile, isp, mix, mix_isp) — bạn sẽ cần ở các bước sau.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Tham số đường dẫn

Tên	Giá trị	Mô tả
type (tùy chọn)	`ipv4`	Loại proxy cần lấy. Nếu bỏ trống, trả về tất cả các loại.

Tham số truy vấn tùy chọn

Tên	Loại	Mô tả
latest	String	Y/N — chỉ trả về proxy từ đơn hàng gần nhất.
orderId	String	Trả về proxy từ một orderId hoặc baseOrderNumber cụ thể.
country	String	Mã quốc gia alpha-3 (vd. FRA, USA).
ends	String	Y — chỉ các proxy sắp hết hạn.

Ví dụ

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/ipv4

Phản hồi

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "can_prolong": true,
        "date_start": "23.06.2024",
        "date_end": "23.07.2024",
        "auto_renew": "N"
      }
    ]
  },
  "errors": []
}

Sao chép id của mỗi proxy cần gia hạn. Đảm bảo can_prolong là true.

Bước 2 — Chọn phương thức thanh toán

Liệt kê các hệ thống thanh toán khả dụng và sao chép id bạn muốn làm paymentId. Để thanh toán bằng số dư tài khoản, bạn có thể bỏ qua bước này và chỉ cần dùng paymentId = 1.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Phản hồi

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Bước 3 — Tính chi phí gia hạn

Trước khi thanh toán, hãy tính chi phí. Ưu đãi theo số lượng và thời hạn thuê được áp dụng như trên website. Bước này không trừ tiền.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/{type}

Nội dung yêu cầu

Tên	Loại	Mô tả
ids	Number / Array	Một ID hoặc mảng ID trong `[ ]`, phân tách bằng dấu phẩy — từ Bước 1.
periodId	String	ID của kỳ gia hạn. Lấy các kỳ khả dụng từ endpoint `/reference/list/{type}`.
paymentId	String	ID hệ thống thanh toán. `1` = số dư, `43` = thẻ đã thêm vào tài khoản.
coupon (tùy chọn)	String	Mã giảm giá, nếu có.

Ví dụ

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/calc/ipv4

Phản hồi — shows the total, your balance, the discount and the proxies being renewed:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 40.4,
    "total": 35.1,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.22,
    "items": [ ... proxies being renewed ... ],
    "orders": 2
  },
  "errors": []
}

Nếu số dư quá thấp, bạn sẽ nhận cảnh báo Insufficient funds:

{
  "status": "error",
  "data": {
    "warning": "Insufficient funds. Total $2. Not enough $33.10",
    "balance": 2,
    "total": 35.1
  },
  "errors": []
}

Bước 4 — Thực hiện gia hạn (trừ vào số dư)

Khi chi phí tính ra hợp lý, hãy tạo đơn gia hạn. Bước này trừ vào số dư của bạn. Dùng cùng tham số như ở Bước 3.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/{type}

Nội dung yêu cầu

Tên	Loại	Mô tả
ids	Number / Array	Một ID hoặc mảng ID trong `[ ]`, phân tách bằng dấu phẩy.
periodId	String	ID kỳ gia hạn (từ `/reference/list/{type}`).
paymentId	String	ID hệ thống thanh toán. `1` = số dư.
coupon (tùy chọn)	String	Mã giảm giá, nếu có.

Ví dụ

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/prolong/make/ipv4

Phản hồi — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 3388536,
    "total": 35.1,
    "listBaseOrderNumbers": [ "1000000_57471911" ],
    "balance": 40.4
  },
  "errors": []
}

Các proxy giữ nguyên IP với ngày hết hạn mới.