Tài liệu API proxy và cách kết nối
Hướng dẫn kết nối proxy residential IPKite với code và công cụ, cùng API dành cho nhà phát triển để truy vấn số dư, lịch sử mua hàng, danh sách proxy - kèm ví dụ minh họa.
Bắt đầu nhanh với residential proxy
Khi mua proxy dân cư, thông tin đăng nhập proxy (username và password) sẽ hiển thị trên màn hình tài khoản. Chỉ cần một địa chỉ kết nối, bạn có thể chỉ định quốc gia, thành phố và phiên làm việc bằng cách thêm tham số vào username. Kiểm tra kết nối ngay với lệnh đơn giản bên dưới.
- Mua hàng: Tại trang thành viên, chọn số GB mong muốn để mua proxy residential.
- Xác nhận: kiểm tra tên người dùng proxy (USERNAME) và mật khẩu (PASSWORD) trên trang thành viên.
- Kết nối: Gửi yêu cầu đến địa chỉ gw.ipkite.com với cổng HTTP 7000 hoặc SOCKS5 7100.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Định dạng thông tin kết nối proxy
Mọi kết nối proxy residential đều sử dụng cùng một địa chỉ. Yêu cầu HTTP và HTTPS được gửi qua cổng 7000, kết nối SOCKS5 qua cổng 7100. Thêm tham số vào sau tên người dùng bằng dấu gạch ngang (-), và chỉ chọn các tham số bạn muốn sử dụng.
| Mục | Giá | Mô tả |
|---|---|---|
| Địa chỉ | gw.ipkite.com | Địa chỉ kết nối cho mọi proxy residential |
| Cổng HTTP/HTTPS | 7000 | Kết nối đến website HTTP/HTTPS qua proxy HTTP |
| Cổng SOCKS5 | 7100 | Kết nối với các công cụ và ứng dụng hỗ trợ SOCKS5 |
| cc | Mã quốc gia hai chữ cái (viết thường) | Ví dụ: cc-us, cc-gb, cc-de |
| city | Tên thành phố (chữ thường, không dấu cách) | Ví dụ: city-newyork, city-london |
| sess | Tên session bằng chữ và số | Duy trì cùng một IP trong khi sử dụng cùng một giá trị |
| ttl | 1~1,440 (phút) | Thời gian duy trì phiên cố định |
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000Ví dụ về proxy luân phiên và phiên cố định
Nếu không thêm giá trị sess vào tên người dùng, proxy sẽ hoạt động như proxy xoay vòng với IP mới được chỉ định cho mỗi yêu cầu. Nếu thêm sess và ttl, nó sẽ trở thành phiên cố định với cùng IP được duy trì trong thời gian đã định (1~1,440 phút). Khi cần IP mới, chỉ cần thay đổi giá trị sess.
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/Ví dụ targeting quốc gia/thành phố
Chọn một trong 174 quốc gia hoặc khu vực với tham số cc và thu hẹp với tham số city. Nhắm mục tiêu quốc gia và thành phố có thể sử dụng với cả phiên luân phiên và cố định.
curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/Ví dụ Python requests Proxy
Trong Python requests, thêm cùng một địa chỉ proxy cho cả HTTP và HTTPS. Để kết nối SOCKS5, cài đặt requests[socks] và thay đổi địa chỉ thành socks5h://.
import requests
proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}
r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)Ví dụ Node.js Proxy
Trong Node.js, bạn có thể sử dụng ProxyAgent của undici hoặc gói https-proxy-agent để kết nối. Chỉ cần thêm một dòng địa chỉ proxy.
import { ProxyAgent, fetch } from "undici";
const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);Xác thực và địa chỉ cơ bản API dành cho nhà phát triển
API dành cho nhà phát triển sử dụng phương thức REST và tất cả phản hồi đều là JSON. Khi bạn tạo khóa API từ trang tài khoản, khóa bắt đầu bằng ipk_live_ sẽ chỉ hiển thị một lần, vì vậy hãy lưu trữ ngay vào nơi an toàn. Mọi yêu cầu đều cần thêm Authorization header với Bearer và khóa API.
- Địa chỉ cơ sở: https://ipkite.com/api/v1
- Tiêu đề xác thực: Authorization: Bearer <API key>
- Giới hạn gọi: 120 lần mỗi phút
- Định dạng phản hồi: JSON, thành công sẽ trả về "ok": true
curl https://ipkite.com/api/v1/balance \
-H "Authorization: Bearer ipk_live_YOUR_API_KEY"Điểm cuối API dành cho nhà phát triển
| Phương thức | Đường dẫn | Nội dung | Giá trị phản hồi chính |
|---|---|---|---|
| GET | /balance | Số dư hiện tại | balance, currency |
| GET | /orders | Danh sách chi tiết mua hàng. | code, product, summary, amount, status, created_at |
| GET | /proxies | Danh sách proxy đã mua | Dân cư: username, password, host, http_port, socks_port, traffic_gb_left / IP cố định: ip, port, username, password, country, expires_at |
{"ok":true,"balance":"25.00","currency":"USD"}Phản hồi lỗi API và giới hạn gọi
Nếu không có hoặc khóa API không khớp, bạn sẽ nhận được phản hồi HTTP 401. Hãy kiểm tra tên tiêu đề, khoảng trắng sau Bearer và toàn bộ khóa. Giới hạn gọi là 120 lần/phút. Để kiểm tra số dư hoặc lưu lượng còn lại định kỳ, bạn có thể thực hiện khoảng 1 lần/phút để sử dụng thoải mái trong giới hạn.
{"ok":false,"error":"unauthorized"}