API指南

一、 登錄軟件後，切換到API選項卡，進入API代理頁面。

二、 頁面分為提取代理和今日列表API兩類，提取代理列表是從“代理列表”獲取新代理；今日列表API用於重用“今日列表”中的代理，這些代理在24h內重復使用不扣費。

三、 提取代理列表

1. 左側列表對應右側的IP篩選條件，可以選擇國家，城市，ISP等篩選，也可以更改API端口。

1. 提取多個時，可以更改IP提取數量

1. 直接提取一個IP，復製API URL，把鏈接放到你要使用的軟件/腳本，然後你就可以自動分配代理了

1. 再次復製更改後API URL，把鏈接放到你要使用的軟件/腳本，然後你就可以自動分配代理了。

四、 今日API列表

1. 今日代理列表：查詢今日列表中的IP信息，包括IP的ID、套餐、國家、城市、當前在線狀態。輸入需要查詢的IP數量，復製API URL，把鏈接放到你要使用的軟件/腳本，然後你就可以查看代理了。

1. 今日列表自定義代理：通過今日API列表查詢到的IP的唯一 ID，添加到API URL中，並選擇轉發端口

復製API URL，把鏈接放到你要使用的軟件/腳本，然後你就可以使用此IP代理了。

1. 左側列表對應右側的IP篩選條件，可以選擇國家，城市，ISP等篩選，也可以更改API端口。

1. 提取多個時，可以更改IP提取數量

1. 直接提取一個今日列表IP，復製API URL，把鏈接放到你要使用的軟件/腳本使用。

您可以像這樣使用参數:

http://10.0.254.168:10101/api/get_ip_list?num=1 //使用來自任何國家的随機代理

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.254168:10101/api/get_ip_list?num=1&country=US&state=NewYork&city=newyork //使用來自美國的随機代理，州:纽約，城市:纽約

http://10.0.254.168:10101/api/get_ip_list?num=1&zip=000 //使用隨機代理 郵政編碼為 000

http://10.0.254.168:10101/api/get_ip_list?num=1&isp=000 //使用指定isp運營商的代理，比如000

http://10.0.254.168:10101/api/get_ip_list?num=1&port=40010//從端口 40010 使用隨機代理

//批次擷取IP，例如修改num後面的数字(num≤99)

http://127.0.0.1:42333/api/get_ip_list?num=1&country=all&state=all&city=all&zip=all&isp=all&ip_time=1&t=1&port=40000

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

-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個。(数量限制999)

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

國家需要输入國家IS0 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 lP 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 lP, please try again later //接囗請求失敗，請檢査網絡環境重試