==== Trích xuất API ====

=== 1. API Extraction – Proxylist ===

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.

{{:wiki:922proxy_api_proxylist.jpg?nolink|API Proxylist}}

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**:
<code text>
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=
</code>

Nếu bạn muốn sử dụng một proxy ngẫu nhiên từ **Hoa Kỳ**:
<code text>
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=
</code>

Nếu bạn muốn sử dụng một proxy ngẫu nhiên từ **Hoa Kỳ – bang New York**:
<code text>
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=
</code>

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**:
<code text>
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=
</code>

Để 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**:
<code text>
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=
</code>

Nếu bạn muốn sử dụng proxy từ một **ISP cụ thể**, ví dụ: **Cybersmart**:
<code text>
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=
</code>

Khi ISP có khoảng trắng trong tên, hãy dùng **%** thay thế. Ví dụ tìm ISP: **Ingululu Communications**:
<code text>
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=
</code>

**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:
<code text>
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=
</code>

**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:
<code text>
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=
</code>

//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:
  - **Số dư tài khoản đã hết**, vui lòng nạp thêm tiền.
  - **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.
  - **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.

=== 2. API Extraction – Todaylist ===

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:
<code text>
http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all
</code>

Giải thích tham số:
  - **port:** cổng bắt đầu dùng để forwarding (mặc định là **30000**)
  - **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.//

{{:wiki:922proxy_api_today_params.jpg?nolink|Tham số API TodayList}}

**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.

{{:wiki:922proxy_api_use_now.jpg?nolink|Nút Use Now}}

**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.

{{:wiki:922proxy_api_copy.jpg?nolink|Nút Copy API}}

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

^ Tham số ^ Mô tả ^ Ví dụ ^
| **country** | Quốc gia (mặc định: All). Có thể lọc theo các quốc gia trong **TodayList**, không phân biệt chữ hoa/thường; sử dụng mã quốc gia. | us |
| **state** | Bang / tiểu bang (mặc định: All) | california |
| **city** | Thành phố (mặc định: All) | losangeles |
| **t** | Định dạng trả về (mặc định: json) | json / text |
| **isp** | Nhà mạng ISP (mặc định: All) | camcast |
| **num** | Số lượng IP cần lấy (tối đa 500 mỗi lần) | 1 |
| **port** | Port forwarding, mặc định 30000 | 30000 |

**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
<code text>
http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=all
</code>

2. Sử dụng proxy forwarding ngẫu nhiên từ Hoa Kỳ
<code text>
http://hostname:port/v1/today_random_ip?num=1&country=US&state=all&city=all&t=json&port=30000&isp=all
</code>

3. Sử dụng proxy forwarding từ Hoa Kỳ – bang Texas
<code text>
http://hostname:port/v1/today_random_ip?num=1&country=US&state=texas&city=all&t=json&port=30000&isp=all
</code>

4. Sử dụng proxy forwarding từ Hoa Kỳ – bang Florida – thành phố Cape Coral
<code text>
http://hostname:port/v1/today_random_ip?num=1&country=US&state=florida&city=capecoral&t=json&port=30000&isp=all
</code>

5. Sử dụng proxy của ISP chỉ định — ví dụ: Comcast Cable Communications LLC
<code text>
http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30000&isp=Comcast%Cable%Communications%LLC
</code>
//(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
<code text>
http://hostname:port/v1/today_random_ip?num=1&country=all&state=all&city=all&t=json&port=30001&isp=all
</code>

7. Forward nhiều IP — ví dụ lấy 5 IP (num=5)
<code text>
http://hostname:port/v1/today_random_ip?num=5&country=all&state=all&city=all&t=json&port=
</code>

**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:
<code text>
http://hostname:port/v1/today_proxy_list?num=1&country=all&state=all&city=all&t=json&isp=all
</code>

**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.

{{:wiki:922proxy_api_today_filter.jpg?nolink|Lọc API TodayList}}

**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.

{{:wiki:922proxy_api_today_copy.jpg?nolink|Sao chép API TodayList}}

Ví dụ request phổ biến:
Để forward nhiều IP, hãy đặt num=3.
<code text>
http://hostname:port/v1/today_proxy_list?num=3&country=all&state=all&city=all&t=json&isp=all
</code>

**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ế)
<code text>
http://hostname:port/v1/today_custom_ip?sn=proxy_sn_from_today_list&t=json&port=30000
</code>

**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.

{{:wiki:922proxy_api_custom_execute.jpg?nolink|Thực thi API tùy chỉnh}}

**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à:
<code text>
http://hostname:port/v1/today_custom_ip?sn=55af27c7d144ffeb5c6fc13e7e6edcad&t=json&port=30002
</code>