[{"data":1,"prerenderedAt":1045},["ShallowReactive",2],{"doc-zh-cn-openapi":3},{"id":4,"title":5,"body":6,"description":1037,"extension":1038,"faq":1039,"meta":1040,"navigation":984,"path":1041,"seo":1042,"stem":1043,"__hash__":1044},"docs\u002Fdocs\u002Fzh-cn\u002Fopenapi.md","🔌 OpenAPI",{"type":7,"value":8,"toc":1025},"minimark",[9,19,33,37,108,111,118,121,126,353,358,396,413,418,440,511,517,520,524,527,531,587,591,603,650,656,659,663,726,730,733,737,749,755,758,762,823,827,829,833,845,851,854,858,904,908,944,948,960,963,998,1002,1005,1013,1021],[10,11,12,13,18],"p",{},"EProxies 对外提供 5 个 HTTP 接口(白名单模式的代理提取与白名单管理)。本页是接口清单速查,详细用法见 ",[14,15,17],"a",{"href":16},"\u002Fdocs\u002Fusage\u002Fapi-extraction","API 提取(白名单模式)","。",[20,21,23],"hint",{"type":22},"info",[10,24,25,26,32],{},"机器可读定义:",[14,27,31],{"href":28,"rel":29},"https:\u002F\u002Fwww.eproxies.io\u002Fdocs\u002Fopenapi.json",[30],"nofollow","openapi.json"," — OpenAPI 3.0 规范,可直接导入 Postman \u002F Swagger UI \u002F Insomnia,或供 AI Agent 加载后自动调用。",[34,35,36],"h2",{"id":36},"基础信息",[38,39,40,53],"table",{},[41,42,43],"thead",{},[44,45,46,50],"tr",{},[47,48,49],"th",{},"项目",[47,51,52],{},"值",[54,55,56,68,81,97],"tbody",{},[44,57,58,62],{},[59,60,61],"td",{},"Base URL",[59,63,64],{},[65,66,67],"code",{},"https:\u002F\u002Fapi.eproxies.net",[44,69,70,73],{},[59,71,72],{},"认证(提取类)",[59,74,75,76,80],{},"请求需从",[77,78,79],"strong",{},"白名单 IP"," 发起,无需账密",[44,82,83,86],{},[59,84,85],{},"认证(管理类)",[59,87,88,89,92,93,96],{},"查询参数 ",[65,90,91],{},"userName"," + ",[65,94,95],{},"userKeyValue","(用户密钥,控制台获取)",[44,98,99,102],{},[59,100,101],{},"代理网关",[59,103,104,107],{},[65,105,106],{},"proxy.eproxies.net:23333","(HTTP\u002FHTTPS\u002FSOCKS5,非本 HTTP API)",[34,109,110],{"id":110},"接口清单",[112,113,115],"h3",{"id":114},"get-gateway_apiextract_ip",[65,116,117],{},"GET \u002Fgateway_api\u002Fextract_ip",[10,119,120],{},"提取代理 — 按条件批量提取代理端点。请求必须从白名单 IP 发起,返回的代理直连使用、无需账密。",[10,122,123],{},[77,124,125],{},"请求参数",[38,127,128,147],{},[41,129,130],{},[44,131,132,135,138,141,144],{},[47,133,134],{},"字段",[47,136,137],{},"类型",[47,139,140],{},"必填",[47,142,143],{},"可选值",[47,145,146],{},"说明",[54,148,149,171,206,229,257,306,325],{},[44,150,151,156,159,162,168],{},[59,152,153],{},[65,154,155],{},"count",[59,157,158],{},"integer",[59,160,161],{},"是",[59,163,164,167],{},[65,165,166],{},"1"," ~ N",[59,169,170],{},"提取数量",[44,172,173,178,181,184,200],{},[59,174,175],{},[65,176,177],{},"country",[59,179,180],{},"string",[59,182,183],{},"否",[59,185,186,189,190,189,193,196,197],{},[65,187,188],{},"US"," ",[65,191,192],{},"GB",[65,194,195],{},"JP"," … \u002F ",[65,198,199],{},"Global",[59,201,202,203,205],{},"国家码(ISO 3166-1 两位);",[65,204,199],{}," 表示不限国家",[44,207,208,213,215,217,226],{},[59,209,210],{},[65,211,212],{},"protocol",[59,214,180],{},[59,216,183],{},[59,218,219,222,223],{},[65,220,221],{},"http"," \u002F ",[65,224,225],{},"socks5",[59,227,228],{},"代理协议",[44,230,231,236,238,240,248],{},[59,232,233],{},[65,234,235],{},"format",[59,237,180],{},[59,239,183],{},[59,241,242,222,245],{},[65,243,244],{},"txt",[65,246,247],{},"json",[59,249,250,251,253,254,256],{},"返回格式;",[65,252,247],{}," 返回对象数组,",[65,255,244],{}," 返回纯文本行",[44,258,259,264,266,268,285],{},[59,260,261],{},[65,262,263],{},"separator",[59,265,180],{},[59,267,183],{},[59,269,270,189,273,189,276,189,279,189,282],{},[65,271,272],{},"crlf",[65,274,275],{},"br",[65,277,278],{},"cr",[65,280,281],{},"lf",[65,283,284],{},"tab",[59,286,287,289,290,293,294,293,297,293,300,293,303],{},[65,288,244],{}," 格式的分隔符:分别对应 ",[65,291,292],{},"\\r\\n","、",[65,295,296],{},"\u003C\u002Fbr>",[65,298,299],{},"\\r",[65,301,302],{},"\\n",[65,304,305],{},"\\t",[44,307,308,313,315,317,320],{},[59,309,310],{},[65,311,312],{},"st",[59,314,180],{},[59,316,183],{},[59,318,319],{},"—",[59,321,322,323],{},"自定义分隔符,填写后替代 ",[65,324,263],{},[44,326,327,332,334,336,344],{},[59,328,329],{},[65,330,331],{},"session",[59,333,180],{},[59,335,183],{},[59,337,338,222,341],{},[65,339,340],{},"sticky",[65,342,343],{},"random",[59,345,346,347,349,350,352],{},"IP 类型:",[65,348,340],{}," 复用同一批 IP,",[65,351,343],{}," 每次随机",[10,354,355],{},[77,356,357],{},"响应字段",[38,359,360,370],{},[41,361,362],{},[44,363,364,366,368],{},[47,365,134],{},[47,367,137],{},[47,369,146],{},[54,371,372,384],{},[44,373,374,379,381],{},[59,375,376],{},[65,377,378],{},"ipAddress",[59,380,180],{},[59,382,383],{},"代理 IP 地址",[44,385,386,391,393],{},[59,387,388],{},[65,389,390],{},"portValue",[59,392,158],{},[59,394,395],{},"代理端口",[10,397,398,401,402,405,406,408,409,412],{},[65,399,400],{},"format=json"," 时返回上述字段构成的对象数组;",[65,403,404],{},"format=txt"," 时按 ",[65,407,263],{}," 分隔返回 ",[65,410,411],{},"IP:端口"," 文本行。",[10,414,415],{},[77,416,417],{},"示例",[419,420,425],"pre",{"className":421,"code":422,"language":423,"meta":424,"style":424},"language-bash shiki shiki-themes github-light","curl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fextract_ip?count=10&country=US&protocol=http&format=json&session=sticky\"\n","bash","",[65,426,427],{"__ignoreMap":424},[428,429,432,436],"span",{"class":430,"line":431},"line",1,[428,433,435],{"class":434},"s7eDp","curl",[428,437,439],{"class":438},"sYBdl"," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fextract_ip?count=10&country=US&protocol=http&format=json&session=sticky\"\n",[419,441,444],{"className":442,"code":443,"language":247,"meta":424,"style":424},"language-json shiki shiki-themes github-light","[\n  { \"ipAddress\": \"203.0.113.10\", \"portValue\": 23333 },\n  { \"ipAddress\": \"203.0.113.11\", \"portValue\": 23333 }\n]\n",[65,445,446,452,482,505],{"__ignoreMap":424},[428,447,448],{"class":430,"line":431},[428,449,451],{"class":450},"sgsFI","[\n",[428,453,455,458,462,465,468,471,474,476,479],{"class":430,"line":454},2,[428,456,457],{"class":450},"  { ",[428,459,461],{"class":460},"sYu0t","\"ipAddress\"",[428,463,464],{"class":450},": ",[428,466,467],{"class":438},"\"203.0.113.10\"",[428,469,470],{"class":450},", ",[428,472,473],{"class":460},"\"portValue\"",[428,475,464],{"class":450},[428,477,478],{"class":460},"23333",[428,480,481],{"class":450}," },\n",[428,483,485,487,489,491,494,496,498,500,502],{"class":430,"line":484},3,[428,486,457],{"class":450},[428,488,461],{"class":460},[428,490,464],{"class":450},[428,492,493],{"class":438},"\"203.0.113.11\"",[428,495,470],{"class":450},[428,497,473],{"class":460},[428,499,464],{"class":450},[428,501,478],{"class":460},[428,503,504],{"class":450}," }\n",[428,506,508],{"class":430,"line":507},4,[428,509,510],{"class":450},"]\n",[112,512,514],{"id":513},"get-gateway_apicountry-list",[65,515,516],{},"GET \u002Fgateway_api\u002Fcountry-list",[10,518,519],{},"支持的国家列表 — 查询白名单模式下可提取的全部国家。",[10,521,522],{},[77,523,125],{},[10,525,526],{},"无请求参数。",[10,528,529],{},[77,530,357],{},[38,532,533,543],{},[41,534,535],{},[44,536,537,539,541],{},[47,538,134],{},[47,540,137],{},[47,542,146],{},[54,544,545,563,575],{},[44,546,547,551,553],{},[59,548,549],{},[65,550,177],{},[59,552,180],{},[59,554,555,556,559,560,562],{},"国家码(ISO 3166-1 两位),用于 ",[65,557,558],{},"extract_ip"," 的 ",[65,561,177],{}," 参数",[44,564,565,570,572],{},[59,566,567],{},[65,568,569],{},"name",[59,571,180],{},[59,573,574],{},"国家名称",[44,576,577,582,584],{},[59,578,579],{},[65,580,581],{},"flag_url",[59,583,180],{},[59,585,586],{},"国旗图标地址",[10,588,589],{},[77,590,417],{},[419,592,594],{"className":421,"code":593,"language":423,"meta":424,"style":424},"curl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fcountry-list\"\n",[65,595,596],{"__ignoreMap":424},[428,597,598,600],{"class":430,"line":431},[428,599,435],{"class":434},[428,601,602],{"class":438}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fcountry-list\"\n",[419,604,606],{"className":442,"code":605,"language":247,"meta":424,"style":424},"[\n  { \"country\": \"US\", \"name\": \"United States\", \"flag_url\": \"https:\u002F\u002Ffile.eproxies.net\u002Fflags\u002Fus.png\" }\n]\n",[65,607,608,612,646],{"__ignoreMap":424},[428,609,610],{"class":430,"line":431},[428,611,451],{"class":450},[428,613,614,616,619,621,624,626,629,631,634,636,639,641,644],{"class":430,"line":454},[428,615,457],{"class":450},[428,617,618],{"class":460},"\"country\"",[428,620,464],{"class":450},[428,622,623],{"class":438},"\"US\"",[428,625,470],{"class":450},[428,627,628],{"class":460},"\"name\"",[428,630,464],{"class":450},[428,632,633],{"class":438},"\"United States\"",[428,635,470],{"class":450},[428,637,638],{"class":460},"\"flag_url\"",[428,640,464],{"class":450},[428,642,643],{"class":438},"\"https:\u002F\u002Ffile.eproxies.net\u002Fflags\u002Fus.png\"",[428,645,504],{"class":450},[428,647,648],{"class":430,"line":484},[428,649,510],{"class":450},[112,651,653],{"id":652},"get-gateway_apiadd-ip",[65,654,655],{},"GET \u002Fgateway_api\u002Fadd-ip",[10,657,658],{},"添加白名单 IP — 把一个出口 IP 加入白名单,加入后该 IP 即可免密提取代理。",[10,660,661],{},[77,662,125],{},[38,664,665,679],{},[41,666,667],{},[44,668,669,671,673,675,677],{},[47,670,134],{},[47,672,137],{},[47,674,140],{},[47,676,143],{},[47,678,146],{},[54,680,681,696,711],{},[44,682,683,687,689,691,693],{},[59,684,685],{},[65,686,91],{},[59,688,180],{},[59,690,161],{},[59,692,319],{},[59,694,695],{},"账号用户名",[44,697,698,702,704,706,708],{},[59,699,700],{},[65,701,95],{},[59,703,180],{},[59,705,161],{},[59,707,319],{},[59,709,710],{},"用户密钥,在控制台获取",[44,712,713,717,719,721,723],{},[59,714,715],{},[65,716,378],{},[59,718,180],{},[59,720,161],{},[59,722,319],{},[59,724,725],{},"要加入白名单的 IP 地址",[10,727,728],{},[77,729,357],{},[10,731,732],{},"返回操作结果对象,以实际响应为准。",[10,734,735],{},[77,736,417],{},[419,738,740],{"className":421,"code":739,"language":423,"meta":424,"style":424},"curl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fadd-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\n",[65,741,742],{"__ignoreMap":424},[428,743,744,746],{"class":430,"line":431},[428,745,435],{"class":434},[428,747,748],{"class":438}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fadd-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\n",[112,750,752],{"id":751},"get-gateway_apidel-ip",[65,753,754],{},"GET \u002Fgateway_api\u002Fdel-ip",[10,756,757],{},"删除白名单 IP — 把一个 IP 移出白名单,移出后该 IP 不能再免密提取。",[10,759,760],{},[77,761,125],{},[38,763,764,778],{},[41,765,766],{},[44,767,768,770,772,774,776],{},[47,769,134],{},[47,771,137],{},[47,773,140],{},[47,775,143],{},[47,777,146],{},[54,779,780,794,808],{},[44,781,782,786,788,790,792],{},[59,783,784],{},[65,785,91],{},[59,787,180],{},[59,789,161],{},[59,791,319],{},[59,793,695],{},[44,795,796,800,802,804,806],{},[59,797,798],{},[65,799,95],{},[59,801,180],{},[59,803,161],{},[59,805,319],{},[59,807,710],{},[44,809,810,814,816,818,820],{},[59,811,812],{},[65,813,378],{},[59,815,180],{},[59,817,161],{},[59,819,319],{},[59,821,822],{},"要移除的白名单 IP",[10,824,825],{},[77,826,357],{},[10,828,732],{},[10,830,831],{},[77,832,417],{},[419,834,836],{"className":421,"code":835,"language":423,"meta":424,"style":424},"curl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fdel-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\n",[65,837,838],{"__ignoreMap":424},[428,839,840,842],{"class":430,"line":431},[428,841,435],{"class":434},[428,843,844],{"class":438}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fdel-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\n",[112,846,848],{"id":847},"get-gateway_apilists-ip",[65,849,850],{},"GET \u002Fgateway_api\u002Flists-ip",[10,852,853],{},"查询白名单列表 — 查询当前账号下全部白名单条目。",[10,855,856],{},[77,857,125],{},[38,859,860,874],{},[41,861,862],{},[44,863,864,866,868,870,872],{},[47,865,134],{},[47,867,137],{},[47,869,140],{},[47,871,143],{},[47,873,146],{},[54,875,876,890],{},[44,877,878,882,884,886,888],{},[59,879,880],{},[65,881,91],{},[59,883,180],{},[59,885,161],{},[59,887,319],{},[59,889,695],{},[44,891,892,896,898,900,902],{},[59,893,894],{},[65,895,95],{},[59,897,180],{},[59,899,161],{},[59,901,319],{},[59,903,710],{},[10,905,906],{},[77,907,357],{},[38,909,910,920],{},[41,911,912],{},[44,913,914,916,918],{},[47,915,134],{},[47,917,137],{},[47,919,146],{},[54,921,922,932],{},[44,923,924,928,930],{},[59,925,926],{},[65,927,378],{},[59,929,180],{},[59,931,79],{},[44,933,934,939,941],{},[59,935,936],{},[65,937,938],{},"remarkText",[59,940,180],{},[59,942,943],{},"备注",[10,945,946],{},[77,947,417],{},[419,949,951],{"className":421,"code":950,"language":423,"meta":424,"style":424},"curl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Flists-ip?userName=USERNAME&userKeyValue=USER_KEY\"\n",[65,952,953],{"__ignoreMap":424},[428,954,955,957],{"class":430,"line":431},[428,956,435],{"class":434},[428,958,959],{"class":438}," \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Flists-ip?userName=USERNAME&userKeyValue=USER_KEY\"\n",[34,961,962],{"id":962},"快速调用",[419,964,966],{"className":421,"code":965,"language":423,"meta":424,"style":424},"# 提取 10 个美国 HTTP 代理(JSON 格式,粘性 IP)\ncurl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fextract_ip?count=10&country=US&protocol=http&format=json&session=sticky\"\n\n# 把当前服务器 IP 加入白名单\ncurl \"https:\u002F\u002Fapi.eproxies.net\u002Fgateway_api\u002Fadd-ip?userName=USERNAME&userKeyValue=USER_KEY&ipAddress=203.0.113.10\"\n",[65,967,968,974,980,986,991],{"__ignoreMap":424},[428,969,970],{"class":430,"line":431},[428,971,973],{"class":972},"sAwPA","# 提取 10 个美国 HTTP 代理(JSON 格式,粘性 IP)\n",[428,975,976,978],{"class":430,"line":454},[428,977,435],{"class":434},[428,979,439],{"class":438},[428,981,982],{"class":430,"line":484},[428,983,985],{"emptyLinePlaceholder":984},true,"\n",[428,987,988],{"class":430,"line":507},[428,989,990],{"class":972},"# 把当前服务器 IP 加入白名单\n",[428,992,994,996],{"class":430,"line":993},5,[428,995,435],{"class":434},[428,997,748],{"class":438},[34,999,1001],{"id":1000},"在-ai-agent-中使用","在 AI Agent 中使用",[10,1003,1004],{},"把规范地址交给 agent,即可让其自动理解全部参数与响应结构:",[419,1006,1011],{"className":1007,"code":1009,"language":1010},[1008],"language-text","https:\u002F\u002Fwww.eproxies.io\u002Fdocs\u002Fopenapi.json\n","text",[65,1012,1009],{"__ignoreMap":424},[10,1014,1015,1016,1020],{},"配合 ",[14,1017,1019],{"href":1018},"\u002Fdocs\u002Fagent-reference","Agent 速查表","(代理网关的 username 参数语法)即为完整接入信息。",[1022,1023,1024],"style",{},"html pre.shiki code .s7eDp, html code.shiki .s7eDp{--shiki-default:#6F42C1}html pre.shiki code .sYBdl, html code.shiki .sYBdl{--shiki-default:#032F62}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sgsFI, html code.shiki .sgsFI{--shiki-default:#24292E}html pre.shiki code .sYu0t, html code.shiki .sYu0t{--shiki-default:#005CC5}html pre.shiki code .sAwPA, html code.shiki .sAwPA{--shiki-default:#6A737D}",{"title":424,"searchDepth":454,"depth":454,"links":1026},[1027,1028,1035,1036],{"id":36,"depth":454,"text":36},{"id":110,"depth":454,"text":110,"children":1029},[1030,1031,1032,1033,1034],{"id":114,"depth":484,"text":117},{"id":513,"depth":484,"text":516},{"id":652,"depth":484,"text":655},{"id":751,"depth":484,"text":754},{"id":847,"depth":484,"text":850},{"id":962,"depth":454,"text":962},{"id":1000,"depth":454,"text":1001},"EProxies 对外 HTTP 接口清单与 OpenAPI 3.0 规范入口,可导入 Postman\u002FSwagger UI 或供 AI Agent 直接加载。","md",null,{},"\u002Fdocs\u002Fzh-cn\u002Fopenapi",{"title":5,"description":1037},"docs\u002Fzh-cn\u002Fopenapi","4DD1_cMGG0lmtOVHhwwMCFXw1llS4Ev99UIZVNkSn9E",1785671055506]