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 technologyWith 240+ countries node resources, it is especially suitable for automated business processes that require fixed export addresses. Developers can test the response speed of agents in different regions through the sandbox environment, and the measured data show that the average latency of European and American nodes is within 180ms.