請注意，該 API 僅適用於從“ProxyList”獲取新代理，不能用於重用“TodayList”中的代理。 以下是如何使用 API 和示例。

登錄軟件後，切換到API選項卡，點擊“Start Proxy”按鈕，使用API時需要保持軟件處於啟動代理狀態

複製api URL，把鏈接放到你要使用的軟件/腳本，然後你就可以自動分配代理了。

您可以像這樣使用參數：

- 使用來自任何國家的隨機代理

http://10.0.254.168:10101/api/get_ip_list?num=1&country=all

- 使用來自美國的隨機代理

http://10.0.254.168:10101/api/get_ip_list?num=1&country=US

- 使用來自美國的隨機代理，州：紐約

http://10.0.254.168:10101/api/get_ip_list?num=1&country=US&state=NewYork

- 使用來自美國的隨機代理，州：紐約，城市：紐約

http://10.0.254.168:10101/api/get_ip_list?num=1&country=US&state=NewYork&city=newyork

- 使用隨機代理 郵政編碼為 000

http://10.0.254.168:10101/api/get_ip_list?num=1&zip=000

- 使用指定isp運營商的代理，比如000

http://10.0.254.168:10101/api/get_ip_list?num=1&isp=000

- 從端口 40010 使用隨機代理

http://10.0.254.168:10101/api/get_ip_list?num=1&port=40010

如果想讓不同的端口使用不同國家的代理，可以這樣設置：

- 40000端口使用美國代理，40001端口使用日本代理，40002端口使用英國代理

http://10.0.254.168:10101/api/port_ip_list?ports=40000-US,40001-JP,40002-GB

如果要釋放端口，可以使用free_port參數：（1.2.7及以上版本）

- 釋放指定端口，例如釋放40000、40001、40002端口

http://127.0.0.1:10101/api/port_free?free_port=40000,40001,40002

- 釋放所有端口

http://127.0.0.1:10101/api/port_free?free_port=all

如果要修改端口的個數和範圍，可以這樣操作。 (1.2.9及以上版本)

- 起始端口30000個，端口個數10個。（數量限制99個）

http://127.0.0.1:10101/api/set_port_range?startstart_port=30000&port_num=10

國家需要輸入國家ISO alpha-2代碼，如果不知道可以訪問：https://www.piaproxy.com/country

如果無法通過API獲取代理，可能會出現以下錯誤及原因：

- PARAMETER_ERROR_NUM

num參數輸入錯誤，請檢查

- PARAMETER_ERROR_IP_TIME

ip_time參數輸入錯誤，請輸入1或2或3

- Error in initialization parameters:MacAdd

客戶端有問題，請重啟或重新安裝

- Please set the allocation port first

未設置端口

- Up to 10 IP of this type can be extracted at a time

抓取次數超過上限，美國靜態IP計劃一次最多抓取10個

- The set port segment does not meet the extraction quantity

抽取次數過多，超出設置的端口範圍

- Port not enabled

當前設置的端口未啟用

- Insufficient ip balance, please buy first

賬戶餘額已用完，請充值

- Failed to get IP, please try again later

接口請求失敗，請檢查網絡環境重試