API 参考

技术文档

将 ProxyHat 集成到您的应用所需的一切资源

快速开始

几分钟内即可启动运行

curl -x http://USERNAME:PASSWORD@proxy.proxyhat.com:8080 \
     https://api.example.com/data

身份验证

使用您的凭据保护 API 请求

API 密钥认证

所有请求都需要在代理 URL 中传递您的 API 密钥。注册后可在控制面板中找到您的 API 密钥。

http://USERNAME:PASSWORD@proxy.proxyhat.com:PORT

代理端点

可用的代理网关端点

住宅

HTTP/HTTPS

residential.proxyhat.com

端口：8080, 8443

具有 AI 筛选质量路由的优质住宅 IP

数据中心

HTTP/HTTPS

dc.proxyhat.com

端口：8080, 8443

用于批量操作的高速数据中心代理

请求参数

使用这些选项自定义您的代理请求

参数	类型	说明	示例
`country`	string	目标国家代码（ISO 3166-1）	`country=US`
`city`	string	目标城市名称	`city=NewYork`
`session`	string	粘性会话标识符	`session=abc123`
`ttl`	number	会话存活时间（秒）	`ttl=600`

代码示例

常用编程语言的实现示例

Python

import requests

proxy = "http://user:pass@residential.proxyhat.com:8080"
response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": proxy, "https": proxy}
)

Node.js

const fetch = require('node-fetch');
const HttpsProxyAgent = require('https-proxy-agent');

const agent = new HttpsProxyAgent(
  'http://user:pass@residential.proxyhat.com:8080'
);
fetch('https://httpbin.org/ip', { agent });

proxyURL, _ := url.Parse(
  "http://user:pass@residential.proxyhat.com:8080",
)
client := &http.Client{
  Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)},
}
resp, _ := client.Get("https://httpbin.org/ip")

响应头

每个代理请求返回的元数据

X-ProxyHat-IP

此请求使用的代理 IP

示例：203.0.113.45

X-ProxyHat-Country

代理 IP 所在国家

示例：US

X-ProxyHat-Latency

请求延迟（毫秒）

示例：48

错误代码

常见错误及处理方法

代码	状态	说明	解决方法
`407`	需要认证	凭据无效或缺失	检查您的用户名和密码
`429`	速率受限	请求过多	减少请求频率或升级计划
`503`	不可用	没有符合条件的可用代理	尝试不同的国家或稍后重试

速率限制

基于您的计划的使用限制

入门版

100

请求/分钟

10 GB 带宽

专业版

500

请求/分钟

100 GB 带宽

企业版

无限

请求/分钟

无限带宽

需要更高限制？

联系我们的团队获取无限请求和专用基础设施的自定义企业计划。

准备好开始了吗？

创建您的账户并在几分钟内开始使用我们的代理基础设施。

开始使用查看定价