文档菜单

Litport文档

将Litport用作代理提供商,或获取公开的免费代理IP列表。这些页面描述已部署版本的行为,包括确切的凭证、限制、错误和响应结构。

选择集成方式#

目标 从这里开始 认证
获取公开的免费代理 免费代理API 无
通过已购买的代理连接 令牌、代理产品和节点 代理令牌的用户名和密码
加密到代理本身的连接 HTTPS代理端点 通过TLS传输的代理令牌用户名和密码
选择PPG地理位置或粘性会话 按流量计费代理参数 代理用户名中的参数
列出已有令牌、读取用量,或为位置可更改的令牌更改位置、轮换或IP Litport API Bearer请求头中的API密钥
读取套餐状态,或管理其IP白名单 套餐API Bearer请求头中的API密钥
免费提供重复的静态HTTPS响应 静态响应缓存 带缓存后缀的代理令牌用户名和密码
让AI助手使用Litport API 面向AI助手的MCP服务器 Bearer请求头中的API密钥

API的写入操作包括令牌的位置、轮换和新IP,以及套餐的IP白名单;每个写入操作都需要Bearer API密钥。令牌本身无法通过API创建或删除。

免费API快速入门#

curl --get 'https://litport.net/api/free-proxy' \
  --data-urlencode 'country=us' \
  --data-urlencode 'protocol=https' \
  --data-urlencode 'limit=25'

响应是不带包装的JSON数组。此端点是公开的,不使用API密钥。

API快速入门#

在设置页面创建API密钥,将其放入环境变量,然后列出已有令牌:

export LITPORT_API_KEY='lit_replace_with_your_key'
curl --fail-with-body 'https://litport.net/api/v1/tokens?limit=20' \
  -H "Authorization: Bearer $LITPORT_API_KEY"

切勿将密钥放入URL、代理用户名、客户端应用、日志或客服消息中。

凭证和标识符#

术语 含义
代理令牌用户名/密码 发送到HTTP或SOCKS5代理端点的数据平面凭证。
代理令牌ID 已认证的API路由使用的稳定、非机密标识符。
用户API密钥(lit_…) 账户控制平面凭证,只能以Authorization: Bearer …形式发送。

API密钥不是代理密码,不能用于建立代理连接。代理令牌ID不是机密。

机器可读资源#

语义化HTML页面为权威版本。HTML、Markdown、导航和智能体资源均由同一批源文件生成,以减少规范偏差。

使用要点#

  • 使用UTC ISO-8601时间戳,例如2026-08-25T12:00:00Z。
  • 将字节计数视为十进制字符串;JavaScript客户端不要把较大的值强制转换为Number。
  • 数据平面的故障请参阅代理错误,REST请求的失败请参阅API错误。两者是不同的错误体系。
  • 报告API故障时请附上X-Request-ID响应头。