Tài liệu API mô tả cách sử dụng các lệnh API của 922S5Proxy và các tham số tùy chọn dùng để tự động hóa và kiểm soát các thao tác lặp lại liên quan đến cài đặt tài khoản, một khu vực hoặc sản phẩm cụ thể, hoặc một proxy cụ thể. Các lệnh API thường được sử dụng trong các đoạn mã (script), và API của 922S5Proxy hỗ trợ nhiều ngôn ngữ lập trình như: shell, Node.js, Java, C#, VB, PHP, Python, Ruby, Perl, v.v.

Tiếp theo, tôi sẽ hướng dẫn bạn cách sử dụng các lệnh API để lấy danh sách proxy.

Trước tiên, hãy lọc quốc gia/khu vực/thành phố/ISP và các tham số khác mà bạn cần để lấy danh sách proxy cho một vị trí cụ thể. Sau đó, bạn có thể sao chép trực tiếp URL và đặt liên kết này vào phần mềm hoặc script bên thứ ba mà bạn muốn sử dụng để chạy proxy.

Ví dụ minh họa:

Cài đặt tham số Quốc gia/Khu vực

Nếu bạn muốn sử dụng một proxy ngẫu nhiên từ bất kỳ quốc gia nào:

http://172.23.254.101:9049/v1/ips?num=1&country=all&state=all&city=all&zip=all&t=txt&port=40000&isp=all&start=&end=

Nếu bạn muốn sử dụng một proxy ngẫu nhiên từ Hoa Kỳ:

http://172.23.254.101:9049/v1/ips?num=1&country=US&state=all&city=all&zip=all&t=txt&port=40000&isp=all&start=&end=

Nếu bạn muốn sử dụng một proxy ngẫu nhiên từ Hoa Kỳ – bang New York:

http://172.23.254.101:9049/v1/ips?num=1&country=US&state=newyork&city=all&zip=all&t=txt&port=40000&isp=all&start=&end=

Nếu bạn muốn sử dụng một proxy ngẫu nhiên từ Hoa Kỳ – bang New York – thành phố New York:

http://172.23.254.101:9049/v1/ips?num=1&country=us&state=newyork&city=newyorkcity&zip=all&t=txt&port=40000&isp=all&start=&end=

Để chỉ định một quốc gia, bạn cần điền mã quốc gia tương ứng. Bạn có thể truy cập trang mã quốc gia để kiểm tra: https://www.922proxy.com/country

Cài đặt tham số Mã bưu điện (Postal Code) / ISP

Nếu bạn muốn sử dụng proxy ngẫu nhiên có mã bưu điện 20006:

http://172.23.254.101:9049/v1/ips?num=1&country=all&state=all&city=all&zip=20006&t=txt&port=3212&isp=all&start=&end=

Nếu bạn muốn sử dụng proxy từ một ISP cụ thể, ví dụ: Cybersmart:

http://172.23.254.101:9049/v1/ips?num=1&country=all&state=all&city=all&zip=all&t=txt&port=40000&isp=cybersmart&start=&end=

Khi ISP có khoảng trắng trong tên, hãy dùng % thay thế. Ví dụ tìm ISP: Ingululu Communications:

http://172.23.254.101:9049/v1/ips?num=1&country=all&state=all&city=all&zip=all&t=txt&port=40000&isp=ingululu%communications&start=&end=

Cài đặt tham số trích xuất IP hàng loạt

Nếu bạn muốn lấy nhiều IP cùng lúc, ví dụ bạn cần lấy 3 IP, hãy đặt num=3:

http://172.23.254.101:9049/v1/ips?num=3&country=all&state=all&city=all&zip=all&t=txt&port=40000&isp=all&start=&end=

Cài đặt tham số chỉ định port khi lấy IP

Nếu bạn muốn sử dụng proxy ngẫu nhiên từ port 20000, hãy dùng:

http://172.23.254.101:9049/v1/ips?num=1&country=all&state=all&city=all&zip=all&t=txt&port=20000&isp=all&start=&end=

Lưu ý quan trọng: API chỉ áp dụng cho các IP lấy từ “ProxyList”, không áp dụng cho các proxy trong “TodayList”. Khi bạn lấy IP thành công, hệ thống sẽ trừ tiền tương ứng.

Nếu không thể lấy proxy thông qua API, có thể xuất hiện các lỗi và nguyên nhân sau:

1. Số dư tài khoản đã hết, vui lòng nạp thêm tiền.
2. Yêu cầu API thất bại, hãy kiểm tra lại môi trường mạng và thử lại.
3. Không có địa chỉ IP nào phù hợp với các tiêu chí đã đặt, vui lòng thay đổi lại các tham số tìm kiếm.

API Todaylist cho phép bạn lấy proxy từ “TodayList”. (Tính năng này được hỗ trợ từ phiên bản 2.1.7 trở lên.)

API Todaylist hỗ trợ 3 phương thức sử dụng sau:

• Forwarding Random Proxy: đặt port để lấy IP ngẫu nhiên.
• TodayList Proxy: lấy thông tin IP của danh sách hoạt động 24 giờ.
• Custom Proxy Extraction: sử dụng mã định danh duy nhất (SN) gắn với port để trích xuất proxy.

Forwarding Random Proxy

Linh hoạt lấy IP proxy ngẫu nhiên thông qua port chuyển tiếp (forwarding)

Ví dụ URL phổ biến:

http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all

Giải thích tham số:

1. port: cổng bắt đầu dùng để forwarding (mặc định là 30000)
2. num: số lượng IP cần lấy (mỗi proxy tương ứng với một port độc lập)

Bước 1: Lọc quốc gia/bang/thành phố/ISP và các tham số bạn cần, nhập số lượng IP, và chọn cổng bắt đầu để forwarding. Chú ý: Bạn chỉ có thể chọn quốc gia/bang/thành phố có trong TodayList. Đối với các IP đang online trong vòng 12 giờ, việc trích xuất lại sẽ không trừ tiền.

Bước 2: Thông tin port forwarding có thể được xem trong danh sách port forwarding hoặc danh sách 24 giờ. Bạn cũng có thể nhấp vào “Use Now” để chuyển trực tiếp sang trình duyệt và sử dụng proxy ngay lập tức.

Bước 3: Thông tin port forwarding sẽ được đồng bộ vào TodayList. Nhấp vào nút “Copy” để sao chép địa chỉ IP cục bộ và port.

Giải thích các tham số API

Dưới đây là cách chỉnh sửa và sử dụng các tham số API, kèm theo ví dụ minh họa:

1. Sử dụng proxy forwarding ngẫu nhiên từ bất kỳ quốc gia nào

http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all

2. Sử dụng proxy forwarding ngẫu nhiên từ Hoa Kỳ

http://hostname:port/v1/today_random_ip?num=1&country=US&state=all&city=all&t=json&port=30000&isp=all

3. Sử dụng proxy forwarding từ Hoa Kỳ – bang Texas

http://hostname:port/v1/today_random_ip?num=1&country=US&state=texas&city=all&t=json&port=30000&isp=all

4. Sử dụng proxy forwarding từ Hoa Kỳ – bang Florida – thành phố Cape Coral

http://hostname:port/v1/today_random_ip?num=1&country=US&state=florida&city=capecoral&t=json&port=30000&isp=all

5. Sử dụng proxy của ISP chỉ định — ví dụ: Comcast Cable Communications LLC

http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=Comcast%Cable%Communications%LLC

(Lưu ý: khoảng trắng trong ISP phải thay bằng % hoặc mã encode URL phù hợp.)

6. Thiết lập proxy forwarding ngẫu nhiên sử dụng port 30001

http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30001&isp=all

7. Forward nhiều IP — ví dụ lấy 5 IP (num=5)

http://hostname:port/v1/today_random_ip?num=5&country=all&state=all&city=all&t=json&port=

Todaylist Proxy

Lấy thông tin IP trong TodayList. IP có thể tạo ra mã định danh duy nhất (SN).

Ví dụ URL phổ biến:

http://hostname:port/v1/today_proxy_list?num=1&country=all&state=all&city=all&t=json&isp=all

Bước 1: Lọc thông tin quốc gia/bang/thành phố/ISP mà bạn cần và nhập số lượng IP muốn lấy.

Bước 2: Sao chép và dán URL API vào phần mềm hoặc script mà bạn muốn sử dụng để chạy proxy. Hoặc bạn có thể nhấp vào “Use Now” để chuyển trực tiếp đến trình duyệt và sử dụng ngay.

Ví dụ request phổ biến: Để forward nhiều IP, hãy đặt num=3.

http://hostname:port/v1/today_proxy_list?num=3&country=all&state=all&city=all&t=json&isp=all

Custom proxy extraction

Yêu cầu port forwarding tùy chỉnh thông qua mã định danh duy nhất của proxy (SN)

Ví dụ URL cơ bản: (tham số SN cần được thay bằng SN thực tế)

http://hostname:port/v1/today_custom_ip?sn=proxy_sn_from_today_list&t=json&port=30000

Bước 1: Thiết lập giá trị port, sau đó sao chép và dán URL API vào trình duyệt của bạn để thực thi.

Bước 2: Sao chép tham số SN của IP tương ứng từ TodayList và thay thế vào URL mẫu.

Ví dụ request phổ biến: Thiết lập:

• port = 30002
• SN = 55af27c7d144ffeb5c6fc13e7e6edcad

Khi đó URL API sẽ là:

http://hostname:port/v1/today_custom_ip?sn=55af27c7d144ffeb5c6fc13e7e6edcad&t=json&port=30002