蜘蛛IP开发者接入
官网主页
  1. 动态住宅流量子账号(永久)
  • Api文档说明
  • 用户IP子账号管理
    • 动态住宅流量子账号(永久)
      • 动态IP Session验证
      • IPAPI提取
        • IPAPI提取说明
        • IP白名单列表-IPAPI提取
        • 新增IP白名单-IPAPI提取
        • IP白名单编辑-IPAPI提取
        • 删除IP白名单-IPAPI提取
        • 新增IP白名单-IP是否占用检测
      • 查询购买的动态住宅流量套餐记录
        GET
      • 获取动态住宅流量子账号列表
        GET
      • 获取动态住宅子账号流量
        GET
      • 设置动态住宅子账号流量上限
        PUT
      • 获取动态住宅子账号上限配置
        GET
      • 批量获取动态住宅子账号上限配置
        GET
      • 批量设置动态住宅子账号流量上限
        PUT
      • 获取动态住宅主账号流量
        GET
      • 获取用户主账号切换token
        GET
      • 购买动态住宅流量
        POST
      • 获取动态住宅对应国家列表
        GET
      • 获取动态住宅州/省份列表
        GET
      • 获取动态住宅城市列表
        GET
      • 获取可用供应商列表
        GET
      • 添加动态住宅流量子账号
        POST
      • 修改动态住宅子账号信息
        PUT
      • 批量修改动态住宅子账号信息
        PUT
      • 自定义动态住宅时长IP子账号用户名和密码
        PUT
      • 删除单个动态住宅流量子账号
        DELETE
      • 批量删除动态住宅子账号信息
        DELETE
      • 子账号白名单清空
        DELETE
      • 子账号白名单读取
        GET
      • 子账号白名单设置
        PUT
    • 动态住宅流量子账号(期限)
      • 动态IP Session验证
      • IPAPI提取
        • IPAPI提取说明
        • IP白名单列表-IPAPI提取
        • 新增IP白名单-IPAPI提取
        • IP白名单编辑-IPAPI提取
        • 删除IP白名单-IPAPI提取
        • 新增IP白名单-IP是否占用检测
      • 查询购买的动态住宅流量套餐记录
      • 获取动态住宅流量子账号列表
      • 购买动态住宅流量
      • 添加动态住宅流量子账号
      • 修改动态住宅子账号信息
      • 批量修改动态住宅子账号信息
      • 删除单个动态住宅流量子账号
      • 批量删除动态住宅子账号信息
      • 获取动态住宅对应国家列表
      • 获取动态住宅州/省份列表
      • 获取动态住宅城市列表
      • 自定义动态住宅时长IP子账号用户名和密码
      • 获取动态住宅子账号流量
      • 获取动态住宅主账号流量
      • 获取用户主账号切换token
      • 获取可用供应商列表
      • 设置动态住宅子账号流量上限
      • 批量设置动态住宅子账号流量上限
      • 获取动态住宅子账号上限配置
      • 批量获取动态住宅子账号上限配置
    • 静态住宅(非原生)时长子账号
      • 预约静态住宅(非原生)IP
      • 获取静态住宅(非原生)时长子账号列表
      • 购买静态住宅(非原生)时长IP
      • 购买静态住宅(非原生)时长测试IP
      • 续费静态住宅(非原生)时长IP
      • 获取静态住宅(非原生)对应国家列表
      • 获取静态住宅(非原生)对应城市列表
      • 自定义静态住宅(非原生)时长IP子账号用户名和密码
      • 批量修改静态住宅(非原生)时长IP子账号密码
      • 批量开关静态住宅(非原生)ip端口连接状态
      • 带宽套餐列表
      • 子账号带宽升级
      • 获取剩余有效期内的带宽详情
      • 子账号带宽趋势查询
      • 静态住宅(非原生)时长子账号申请退单
    • 静态住宅(原生)时长子账号
      • 预约静态住宅(原生)IP
      • 获取静态住宅(原生)时长子账号列表
      • 购买静态住宅(原生)时长IP
      • 购买静态住宅(原生)时长测试IP
      • 续费静态住宅(原生)时长IP
      • 获取静态住宅(原生)对应国家列表
      • 获取静态住宅(原生)对应城市列表
      • 自定义静态住宅(原生)时长IP子账号用户名和密码
      • 批量修改静态住宅(原生)时长IP子账号密码
      • 批量开关静态住宅(原生)ip端口连接状态
      • 带宽套餐列表
      • 子账号带宽升级
      • 获取剩余有效期内的带宽详情
      • 子账号带宽趋势查询
      • 静态住宅(原生)时长子账号申请退单
    • 静态住宅(IPV6)时长子账号
      • 购买静态住宅(IPV6)时长IP
      • 获取静态住宅(IPV6)时长子账号列表
      • 续费静态住宅(IPV6)时长IP
      • 获取静态住宅(IPV6)对应国家列表
      • 获取静态住宅(IPV6)对应城市列表
      • 自定义静态住宅(ipv6)时长IP子账号用户名和密码
    • 数据中心时长子账号
      • 预约数据中心IP
      • 获取数据中心时长子账号列表
      • 购买数据中心时长IP
      • 购买数据中心时长测试IP
      • 续费数据中心时长IP
      • 获取数据中心对应国家列表
      • 获取数据中心对应城市列表
      • 自定义数据中心时长IP子账号用户名和密码
      • 批量修改数据中心时长IP子账号密码
  • 工具管理
    • 查询国家编码
    • 获取优惠券列表
    • 获取官网价格
    • 获取用户价格
  • Token管理
    • 检测Token是否过期
    • 刷新Token
  • 用户管理
    • 发送手机验证码
    • 发送邮箱验证码
    • 会员注册
    • 会员登陆
    • 获取用户信息
    • 重置密码
    • 退出登陆
  • 数据模型
    • 示例数据模型
      • Pet
      • Category
      • Tag
  1. 动态住宅流量子账号(永久)

动态IP Session验证

(Session)使用说明#

基本格式#

{账号}-ss-{随机值}:{密码}@proxy.zhizhuip.com:5001
在账号后面拼接参数即可控制国家、时长、会话等,密码不变。
完整参数格式:
{账号}-cty-{国家}-st-{州/省}-ct-{城市}-ss-{会话ID}-tm-{ip时长}-spec-{资源池}:{密码}@proxy.zhizhuip.com:5001

参数说明#

参数含义是否必填说明
账号子账号名必填,且必须在第一位如 apitest-1
cty国家代码可选如 US、TW、JP,不指定则随机国家
st州/省可选需先指定国家才生效,带空格用单引号如 'New York'
ct城市可选需先指定国家才生效,带空格用单引号如 'Lehighton'
ss会话ID可选核心参数,不同的 ss 值 = 不同的IP会话,详见下方说明
tmIP在线时长可选带单位:s(秒)、m(分钟)、h(小时)
spec资源池可选可选值:4 或 284,不指定则使用默认资源池
除了账号必须在第一个位置上,其他字段位置随意,所有字段都是可选的,不指定则按照子账号原本的参数执行。
如果指定时长内分配的ip掉线,为保障请求网络可用性,系统会自动为您切换到其它IP。

从简单到复杂:逐步上手#

第1步:最基本的代理请求
第2步:指定IP在线时长10分钟
第3步:指定国家 + IP在线时长10分钟
第4步:需要5条美国在线10分钟的独立IP —— 每条指定不同的 ss 值
每条请求的 ss 值不同,所以会分别获得5个独立的IP,每个IP在线10分钟,到期自动切换。

ss 会话参数详解(重点)#

ss 是会话的唯一标识,可以理解为:更换一个 ss 值 = 创建了一个新的子账号。
每个不同的 ss 值会分配一个独立的IP
在 tm 指定的时长内,相同 ss 值会保持同一个IP
到期后自动切换新IP,但该 ss 会话仍然保持
如果需要同时使用多个IP,必须使用不同的 ss 值
⚠️ 重要规则:
如果每次请求都想换IP(一次一换),不要带 ss 参数
如果需要保持IP在指定时长内不变,ss 参数必填,且每个独立会话必须使用不同的 ss 值
简单记忆:不带 ss = 每次换IP,带 ss = 保持IP

❌ 错误用法:多个会话使用相同的 ss 值#

问题:两个请求使用了相同的 ss-zaHJiS,会导致会话冲突,IP不能正确隔离。

✅ 正确用法:每个会话使用不同的 ss 值#

示例:同一地区同时需要3个独立IP会话
第一个30分钟的IP会话:
第二个30分钟的IP会话:
第三个30分钟的IP会话:
每个 ss 值不同,所以会分别获得3个独立的IP,互不影响。

通过 tm 参数灵活控制在线时长#

不再需要批量修改IP在线时长,直接在请求中通过 tm 参数指定即可,更加灵活方便。
示例:将在线时长设为20分钟
第一个IP(在线20分钟,到期自动切换):
第二个IP(在线20分钟,到期自动切换):
只需更换 ss 参数值,即可获得一个全新的IP会话,无需修改子账号配置。

常用场景示例#

注意: 部分州/省、城市名称含有空格(如 New York、Los Angeles),在命令行中需要用单引号包裹,否则会导致请求解析时被截断。例如:st-'New York'、ct-'Los Angeles'。
1. 指定国家+州+城市,30分钟切换
2. 只指定国家,30分钟切换
3. 指定美国纽约,1分钟切换
4. 指定资源池284,美国弗罗里达,2分钟切换
5. 随机国家,1分钟切换
6. 284资源池全球随机
7. 全球随机,5分钟切换一次
8. 不带 ss,实现IP一次一换(每次请求换IP)
9. 不带地区参数,实现地区随机切换

资源池性能参考#

指标资源池 4资源池 284
压测QPS32k16k
成功率96%(稳定)95%(稳定)
美区带宽最高40G20G
最大同时连接数~300W~70W
扩容支持支持-
P95平均响应时长1.8s-
使用 spec-4 或 spec-284 指定资源池,不指定则使用默认配置。
修改于 2026-05-11 05:45:53
上一页
Api文档说明
下一页
IPAPI提取说明
Built with