跳到主要内容

共享住宅、移动和数据中心代理的API

注意：

在使用API工具之前，请确保您的IP地址不在您所使用服务的白名单上。IP白名单的优先级高于常规代理列表和API工具登录信息。

如何通过API使用共享代理（住宅、移动、数据中心）​

基本用法​

认证信息：
  • 代理主机： pool.infatica.io
  • 代理端口： 10000
  • 代理类型： HTTPS/SOCKS5（自动检测）
  • 代理用户名： xxx
  • 代理密码： xxx

pool.infatica.io 是一个基于地理位置的DNS记录，它会根据您服务器的位置自动调整。

如果您想手动为住宅代理选择网关，请使用以下地址：

  • poolus.infatica.io - 适用于北美洲和南美洲；
  • pooleu.infatica.io - 适用于除美洲以外的所有地区；
  • poolasia.infatica.io - 适用于亚洲。

此外，除了HTTP和SOCK5协议，我们也支持HTTPS协议，但出于性能考虑，我们不建议使用该协议。

对于并发请求，请使用10000-10999范围内的不同端口。

重要提示： 每个IP地址端口对应一个唯一的IP地址（例如，pool.infatica.io:10005和pool.infatica.io:10006是不同的IP地址）。

如何找到用于API的代理登录信息​

用户名和密码：

API工具仅使用您套餐中的一个登录信息，您可以在您的Infatica账户中找到该信息。您代理列表中的其他代理登录信息将不会用于 API。

  1. 点击左侧菜单中的“我的服务”。

  1. 向下滚动到“生成代理列表”部分，然后点击“API 工具”。

  1. 您将进入一个使用API的页面。

您的代理用户名和密码分别位于“代理用户”和“代理密码”选项中。请使用此用户名和密码作为使用API的唯一账户。

主机格式：​

域名：​

Curl命令行示例：

注意

每一次请求都会从全球IP池中分配一个新的出口IP地址。

将IP出口限制在特定国家​

友情提醒：

您可以按以下方式将国家数据添加到登录信息中：xxx_c_US 其中，“US”是根据ISO 3166-1标准的双字母大写国家代码：

国家代码（点击此处展开）
CodeCountry nameCodeCountry nameCodeCountry name
ADAndorraGLGreenlandNONorway
AEUnited Arab EmiratesGMGambiaNPNepal
AFAfghanistanGNGuineaNRNauru
AGAntigua and BarbudaGPGuadeloupeNUNiue
AIAnguillaGQEquatorial GuineaNZNew Zealand
ALAlbaniaGRGreeceOMOman
AMArmeniaGSSouth Georgia and the South Sandwich IslandsPAPanama
AOAngolaGTGuatemalaPEPeru
AQAntarcticaGUGuamPFFrench Polynesia
ARArgentinaGWGuinea-BissauPGPapua New Guinea
ASAmerican SamoaGYGuyanaPHPhilippines
ATAustriaHKHong KongPKPakistan
AUAustraliaHMHeard Island and McDonald IslandsPLPoland
AWArubaHNHondurasPMSaint Pierre and Miquelon
AXÅland IslandsHRCroatiaPNPitcairn
AZAzerbaijanHTHaitiPRPuerto Rico
BABosnia and HerzegovinaHUHungaryPSPalestine, State of
BBBarbadosIDIndonesiaPTPortugal
BDBangladeshIEIrelandPWPalau
BEBelgiumILIsraelPYParaguay
BFBurkina FasoIMIsle of ManQAQatar
BGBulgariaINIndiaRERéunion
BHBahrainIOBritish Indian Ocean TerritoryRORomania
BIBurundiIQIraqRSSerbia
BJBeninIRIran (Islamic Republic of)RURussian Federation
BLSaint BarthélemyISIcelandRWRwanda
BMBermudaITItalySASaudi Arabia
BNBrunei DarussalamJEJerseySBSolomon Islands
BOBolivia (Plurinational State of)JMJamaicaSCSeychelles
BQBonaire, Sint Eustatius and SabaJOJordanSDSudan
BRBrazilJPJapanSESweden
BSBahamasKEKenyaSGSingapore
BTBhutanKGKyrgyzstanSHSaint Helena, Ascension and Tristan da Cunha
BVBouvet IslandKHCambodiaSISlovenia
BWBotswanaKIKiribatiSJSvalbard and Jan Mayen
BYBelarusKMComorosSKSlovakia
BZBelizeKNSaint Kitts and NevisSLSierra Leone
CACanadaKPKorea (Democratic People's Republic of)SMSan Marino
CCCocos (Keeling) IslandsKRKorea, Republic ofSNSenegal
CDCongo, Democratic Republic of theKWKuwaitSOSomalia
CFCentral African RepublicKYCayman IslandsSRSuriname
CGCongoKZKazakhstanSSSouth Sudan
CHSwitzerlandLALao People's Democratic RepublicSTSao Tome and Principe
CICôte d'IvoireLBLebanonSVEl Salvador
CKCook IslandsLCSaint LuciaSXSint Maarten (Dutch part)
CLChileLILiechtensteinSYSyrian Arab Republic
CMCameroonLKSri LankaSZEswatini
CNChinaLRLiberiaTCTurks and Caicos Islands
COColombiaLSLesothoTDChad
CRCosta RicaLTLithuaniaTFFrench Southern Territories
CUCubaLULuxembourgTGTogo
CVCabo VerdeLVLatviaTHThailand
CWCuraçaoLYLibyaTJTajikistan
CXChristmas IslandMAMoroccoTKTokelau
CYCyprusMCMonacoTLTimor-Leste
CZCzechiaMDMoldova, Republic ofTMTurkmenistan
DEGermanyMEMontenegroTNTunisia
DJDjiboutiMFSaint Martin (French part)TOTonga
DKDenmarkMGMadagascarTRTürkiye
DMDominicaMHMarshall IslandsTTTrinidad and Tobago
DODominican RepublicMKNorth MacedoniaTVTuvalu
DZAlgeriaMLMaliTWTaiwan, Province of China
ECEcuadorMMMyanmarTZTanzania, United Republic of
EEEstoniaMNMongoliaUAUkraine
EGEgyptMOMacaoUGUganda
EHWestern SaharaMPNorthern Mariana IslandsUMUnited States Minor Outlying Islands
EREritreaMQMartiniqueUSUnited States of America
ESSpainMRMauritaniaUYUruguay
ETEthiopiaMSMontserratUZUzbekistan
FIFinlandMTMaltaVAHoly See
FJFijiMUMauritiusVCSaint Vincent and the Grenadines
FKFalkland Islands (Malvinas)MVMaldivesVEVenezuela (Bolivarian Republic of)
FMMicronesia (Federated States of)MWMalawiVGVirgin Islands (British)
FOFaroe IslandsMXMexicoVIVirgin Islands (U.S.)
FRFranceMYMalaysiaVNViet Nam
GAGabonMZMozambiqueVUVanuatu
GBUnited Kingdom of Great Britain and Northern IrelandNANamibiaWFWallis and Futuna
GDGrenadaNCNew CaledoniaWSSamoa
GEGeorgiaNENigerYEYemen
GFFrench GuianaNFNorfolk IslandYTMayotte
GGGuernseyNGNigeriaZASouth Africa
GHGhanaNINicaraguaZMZambia
GIGibraltarNLNetherlandsZWZimbabwe

Curl命令行示例：

curl -v -x xxx_c_US:xxx@pool.infatica.io:10000 https://www.google.com

将IP出口限制在特定行政区​

友情提醒：

您可以按以下方式将行政区数据添加到登录信息中： xxx_sd_ID

您可以在此处找到行政区ID列表。

Curl命令行示例：

curl -v -x xxx_sd_1906:xxx@pool.infatica.io:10000 https://www.google.com

将IP出口限制在特定城市​

友情提醒：

您可以按以下方式将城市数据添加到登录信息中：xxx_city_Paries

您可以同时指定国家和城市，例如：xxx_c_US_city_New-York

Curl命令行示例：

curl -v -x xxx_city_Paris:xxx@pool.infatica.io:10000 https://www.google.com
城市名称：

请用连字符“-”替换城市英文名称中的空格。例如：

curl -v -x xxx_city_New-York:xxx@pool.infatica.io:10000 https://www.google.com

将IP出口限制在特定的ISP​

友情提醒：

您可以按以下方式将互联网服务提供商数据添加到登录信息中：xxx_isp_ID

您可以在此处找到互联网服务提供商的ID列表。

Curl命令行示例：

curl -v -x xxx_isp_51811:xxx@pool.infatica.io:10000 https://www.google.com

将IP出口限制在特定的ASN​

友情提醒：

您可以按以下方式将ASN编号添加到登录信息中：xxx_asn_12389

Curl命令行示例：

curl -v -x xxx_asn_12389:xxx@pool.infatica.io:10000 https://www.google.com

将IP出口限制在特定的ZIP​

友情提醒：

您可以按以下方式将ZIP编号添加到登录信息中：xxx_c_US_zip_10001

ZIP编号必须与国家代码配合使用才有效。

Curl命令行示例：

会话控制​

会话 ID​

友情提醒：

如果您需要重复使用同一个IP，您可以通过以下方式在登录信息中添加会话ID：xxx_s_100

此时，100就是您的会话ID。您可以使用任何字母数字字符串作为会话ID。

只要该IP出口保持在线，您就在后续请求中重复使用该会话ID。

非活跃会话的时效为60分钟。

Curl命令行示例：

curl -v -x xxx_c_US_s_100:xxx@pool.infatica.io:10000 https://www.google.com

会话时长​

您可以将会话时长与会话ID一同添加到登录信息中，从而设置会话时长（轮换时间）。格式如下： xxx_s_100_ttl_30s

ttl 参数须与会话ID搭配，用于设置会话时长。在使用 ttl 参数时，可以添加后缀 s（秒）、m（分钟）、h（小时）来明确时间单位。当指定的会话时长结束后，该会话内发起的请求会触发新建会话，并分配一个新的IP地址（这是另一种给每个会话自定义 IP 轮换时间的办法）

10秒会话示例：

curl -v -x xxx_c_US_s_100_ttl_10s:xxx@pool.infatica.io:10000 https://www.google.com

15分钟会话示例：

curl -v -x xxx_c_US_s_100_ttl_15m:xxx@pool.infatica.io:10000 https://www.google.com

1小时会话示例：

curl -v -x xxx_c_US_s_100_ttl_1h:xxx@pool.infatica.io:10000 https://www.google.com

轮换模式​

轮换模式控制在请求路由期间，没有出口节点可用时的处理方式。如果需要启用这个选项，在您的登陆信息中附加 _rotm_<int>，其中的 <int> 值的可选项如下：

值行为
0即时轮换（默认）。如果没有出口节点，则立即尝试寻找另一个。
15秒延迟。如果没有出口节点，将会出现一段时间的响应错误，直到失效的出口节点被从列表中排除，并且该端口被分配一个新的IP地址。
2无轮换。

注意：轮换模式必须与会话（_s_<id>）和 TTL（_ttl_<duration>）参数一起使用 -- 可以同时使用，也可以分别使用。

示例：TTL设置为1小时，轮换模式为即时轮换（instant rotation）：

curl -v -x xxx_c_US_s_100_ttl_1h_rotm_0:xxx@pool.infatica.io:10000 https://www.google.com

示例：TTL设置为1小时，轮换模式为不轮换（no rotation）：

curl -v -x xxx_c_US_s_100_ttl_1h_rotm_2:xxx@pool.infatica.io:10000 https://www.google.com

不同的地理定位组合​

友情提醒：

您还可以将不同的定位组合进行搭配使用，包括国家、城市、ISP、ASN和会话。

国家、城市、ASN和会话的组合示例。

curl -v -x xxx_c_US_city_New-York_asn_12271_s_100:xxx@pool.infatica.io:10000 https://www.google.com

国家、城市和会话的组合示例。

curl -v -x xxx_c_US_city_New-York_s_100:xxx@pool.infatica.io:10000 https://www.google.com

国家和ASN的组合示例。

curl -v -x xxx_c_US_asn_12271:xxx@pool.infatica.io:10000 https://www.google.com