Hướng dẫn này cho biết cách tạo danh sách proxy residential nhắm theo địa lý có vòng xoay.
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 1 — Kiểm tra gói
Xác nhận gói residential đang hoạt động và còn lưu lượng. Sao chép package_key.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/package
Phản hồi
{
"status": "success",
"data": {
"rotation": 60,
"traffic_limit": "7516192768",
"traffic_usage": "10",
"traffic_left": "10",
"package_key": "1234567890abcdefedcb",
"expired_at": "d.m.Y",
"is_active": true,
"tarif_id": 2
},
"errors": []
}
Bước 2 — Lấy các vị trí khả dụng
Tải các vị trí khả dụng (quốc gia / vùng / thành phố / ISP) để biết giá trị GEO chính xác. Phản hồi là JSON/ZIP với cây GEO đầy đủ.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/geo
Phản hồi
[
{
"code": "US",
"name": "United States",
"regions": [
{ "name": "Washington", "cities": [ { "name": "Garfield", "isps": [ "FIRST-STEP" ] } ] }
]
}
]
Bước 3 — Tạo danh sách
Tạo danh sách với tiêu đề, đối tượng geo (từ Bước 2), cài đặt export và giá trị vòng xoay.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Nội dung yêu cầu
Tên | Loại | Mô tả |
title | String | Tên danh sách. |
whitelist (tùy chọn) | String | IP để xác thực. Để trống để dùng login:password. |
geo | object | Đối tượng gồm |
export | object | Đối tượng: |
rotation | Number | Vòng xoay: |
Ví dụ
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/list/add
Phản hồi
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"geo": { "country": "US", "region": "Washington", "city": "Garfield", "isp": "FIRST-STEP" },
"export": { "ports": 10000, "ext": "txt" }
},
"errors": []
}
Bước 4 — Kiểm tra danh sách mới
Liệt kê các danh sách residential của bạn để xác nhận đã tạo và lấy thông tin kết nối.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/resident/lists
Phản hồi
{
"status": "success",
"data": [
{ "id": 561, "title": "US Washington", "login": "3c8aa1d4", "rotation": 60 }
],
"errors": []
}