跳到正文
只只HTTP代理只只HTTP代理- Zzhttp.com -认证领赠送余额 注册
本中心目录
API 文档 · 静态 IP 功能

查询静态 IP 分组

查询静态 IP 分组。仅访问当前令牌账户的数据。

只只HTTP技术团队维护更新于 2026年10月6日

接口与认证

GET/openapi/v1/static/groups

查询静态 IP 分组。仅访问当前令牌账户的数据。

使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。

示例为合成数据与占位凭据，仅说明结构。接口合同不代表目标环境已开放，开放状态以控制台为准。

下载 OpenAPI · 导入 Apifox / Postman

请求参数

查询与路径参数
字段类型必填默认值 / 限制说明
api_keystring是Query · 唯一非空账户 API 令牌，在受控服务端保存；示例使用占位符。

无请求体。

请求示例

Shell · STATIC_API_KEY 使用账户令牌
curl --request GET \
  "https://api.zzhttp.com/openapi/v1/static/groups?api_key=${STATIC_API_KEY}"

成功响应

成功

响应不包含代理密码，凭据仅由专用接口返回。

响应字段（含嵌套字段）
字段类型必填默认值 / 限制说明
codeinteger是固定 200统一数字业务码：HTTP 与业务码成功均为 200；异步受理不代表交付完成。
messagestring是—服务端结果说明。
requestIdstring是—本次请求的追踪 ID，用于排障，不是业务幂等编号。
dataobject是—本接口业务数据。
data.itemsobject[]是—本人分组列表，按 ID 升序；没有分组时为空数组。
data.items[].groupIdinteger是最小 1分组 ID。
data.items[].namestring是—自定义分组名称。
data.items[].createdAtstring是格式 date-time创建时间，RFC3339。
data.items[].updatedAtstring是格式 date-time最后更新时间，RFC3339。
JSON · HTTP 200
{
  "code": 200,
  "message": "成功",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "data": {
    "items": [
      {
        "groupId": 12,
        "name": "Work",
        "createdAt": "2026-10-06T08:00:00Z",
        "updatedAt": "2026-10-06T08:00:00Z"
      }
    ]
  }
}

错误与重试

读取请求遇到 429 按 Retry-After 等待；500/503 可有限重试。分组创建结果不明时先查询分组列表；移动同一目标可安全重试。

错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。

API 文档静态 API 概览API 文档查询静态实例列表

这篇内容解决了你的问题吗？

反馈只用于改进公开文档，不会提交账号或请求信息。