Static ISP Proxy API Interface Documentation|Static ISP Proxy API Documentation

Static ISP Proxy API Interface Documentation Core Essentials

When using a static ISP proxy, the API interface is the most direct interaction tool for the developer. ipipgo provides API documentation using themodular design, splitting the functions such as request authentication, IP acquisition, and status query into independent units. For example, in the authentication session, developers need to pass the API key through the request header'sX-Auth-Keyfield transfer, this design is more secure than the traditional parameter splicing approach.

The four-step procedure for interface calls

Demonstrate the base call flow with the curl command:

curl -X GET "https://api.ipipgo.com/isp-proxy"
-H "X-Auth-Key: your own key"
-d "region=us&protocol=socks5"

parametersregionsupport for country code abbreviations.protocolThree protocols, socks5/http/https, are available. ipipgo's response data has a nested structure, where thedata.proxy_listfield contains information about available proxies.meta.expire_timeDisplays the current session expiration date.

Dynamic and Static Proxy Comparison Table

Three axes of exception handling

run into403 error codeWhen: 1) Check if the key has expired 2) Verify IP whitelist settings 3) Confirm account balance status. ipipgo's response body contains theerror.detailsfield, which will explicitly indicate the specific type of error, e.g.quota_exhaustedIndicates exhaustion of quota.

Practical QA Selection

Q: How can I verify if the agent is in effect?
A: Calling ipipgo's/verifyinterface, which returns the result in theorigin_ipfield displays the currently used egress IP

Q: Can a single API key be used for multiple devices?
A: Support, but recommend adoptionX-Device-IDThe request header distinguishes between devices, and the ipipgo console allows you to view usage details for each device.

Q: How to deal with IP blocking?
A: Add in the request parametersrotate=trueInstant replacement can be triggered and ipipgo is guaranteed to return a new IP within 200ms

Security Hardening Program

It is recommended that protection be strengthened in three areas: 1) the use ofRequest signature mechanismPrevent Replay Attacks 2) ConfigurationIP whitelisting + time slotsDouble Restrictions 3) via ipipgo'swebhookfunction receives exception notifications. These measures reduce API risk by more than 90%.

Static ISP Proxy Support for ipipgosession keeping technology，在TCP连接中断后30秒内重连可继续使用原IP。配合240+国家节点资源，特别适合需要固定出口地址的自动化业务流程。开发者可通过沙箱环境测试不同地区代理的响应速度，实测数据显示欧美节点平均在180ms以内。