IPKite

代理API文档与连接方法

获取代码集成指南和开发者API文档，包含余额查询、购买记录、代理列表等接口调用示例。

获取API密钥

住宅代理快速入门

购买住宅代理后，会员页面会显示代理用户名和密码。连接地址只有一个，通过在用户名中添加值来指定国家、城市和会话。使用以下命令可以立即检查连接。

  • 购买: 在会员页面选择所需GB数购买住宅代理。
  • 确认: 在会员页面查看代理用户名(USERNAME)和密码(PASSWORD)。
  • 连接: 通过gw.ipkite.com地址，使用HTTP 7000端口或SOCKS5 7100端口发送请求。
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

代理连接信息格式

所有住宅代理连接使用相同地址：HTTP/HTTPS请求通过7000端口，SOCKS5连接通过7100端口。在用户名后添加连字符(-)附加参数，可按需组合使用。

项目值说明
地址gw.ipkite.com所有住宅代理连接地址
HTTP/HTTPS端口7000通过HTTP代理连接HTTP和HTTPS网站
SOCKS5端口7100在支持SOCKS5的工具和应用程序中连接
cc两位国家代码（小写）例：cc-us, cc-gb, cc-de
city城市名称（小写无空格）例：city-newyork, city-london
sess英文/数字会话名使用相同值时保持IP不变
ttl1-1,440（分钟）保持固定会话的时间
USERNAME-cc-us-city-newyork-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000

轮换代理与固定会话示例

如果用户名中不添加sess值，则每次请求都会分配新IP的旋转代理。添加sess和ttl后，即可在ttl指定的时间内（1~1,440分钟）保持相同IP的固定会话。需要新IP时，只需更改sess值即可。

curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/
curl -x http://USERNAME:PASSWORD@gw.ipkite.com:7000 https://example.com/

国家和城市定位示例

使用cc参数从174个国家·地区中选择一个，使用city参数进一步缩小到主要城市。国家·城市定位适用于旋转和固定会话。

curl -x http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000 https://example.com/

Python requests代理示例

在Python requests中，HTTP和HTTPS使用相同的代理地址。如需通过SOCKS5连接，需安装requests[socks]并将地址改为socks5h://。

import requests

proxy = "http://USERNAME-cc-us-sess-a1b2c3-ttl-30:PASSWORD@gw.ipkite.com:7000"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://example.com/", proxies=proxies, timeout=30)
print(r.status_code)

Node.js代理示例

在Node.js中，可以使用undici的ProxyAgent或https-proxy-agent包进行连接。两种方法只需输入一行代理地址即可。

import { ProxyAgent, fetch } from "undici";

const agent = new ProxyAgent("http://USERNAME-cc-de:PASSWORD@gw.ipkite.com:7000");
const res = await fetch("https://example.com/", { dispatcher: agent });
console.log(res.status);

开发者API认证与基础地址

开发者API采用REST架构，所有响应均为JSON格式。在账户页面生成API密钥后，仅显示一次的ipk_live_开头密钥请立即安全保存。所有请求需在Authorization头部添加Bearer和API密钥。

  • 基础地址: https://ipkite.com/api/v1
  • 认证头: Authorization: Bearer <API密钥>
  • 调用限制: 每分钟120次
  • 响应格式: JSON，成功返回"ok": true
curl https://ipkite.com/api/v1/balance \
  -H "Authorization: Bearer ipk_live_YOUR_API_KEY"

开发者API端点

请求方法路径内容主要响应值
GET/balance当前余额balance, currency
GET/orders购买明细列表code, product, summary, amount, status, created_at
GET/proxies已购代理列表住宅：username, password, host, http_port, socks_port, traffic_gb_left / 固定IP：ip, port, username, password, country, expires_at
{"ok":true,"balance":"25.00","currency":"USD"}

API错误响应与调用限制

若API密钥缺失或不匹配将返回HTTP 401及以下响应。请检查请求头名称、Bearer后的空格及完整密钥。调用限速为每分钟120次，定期查询余额或剩余流量时建议每分钟不超过1次以确保限额充裕。

{"ok":false,"error":"unauthorized"}
代理API文档，住宅代理连接方法与代码示例 | IPKite