跳到正文
本中心目录
API 文档 · 静态 IP 功能

查询静态实例详情

查看实例状态、节点、到期时间和能力。

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

接口与认证

GET/openapi/v1/static/instances/{instanceId}

查询实例。仅访问当前令牌账户的数据。

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

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

下载 OpenAPI · 导入 Apifox / Postman

请求参数

查询与路径参数
字段类型必填默认值 / 限制说明
api_keystring是Query · 唯一非空账户 API 令牌,在受控服务端保存;示例使用占位符。
instanceIdinteger是path · 最小 1;格式 int64实例 ID,属于当前账户;分组绑定此 ID。

无请求体。

请求示例

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

成功响应

成功

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

响应字段(含嵌套字段)
字段类型必填默认值 / 限制说明
codeinteger是固定 200统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。
messagestring是—服务端结果说明。
requestIdstring是—本次请求的追踪 ID,用于排障,不是业务幂等编号。
dataobject是—本接口业务数据。
data.instanceIdinteger是最小 1;格式 int64实例 ID,属于当前账户;分组绑定此 ID。
data.offerIdinteger是最小 1;格式 int64当前可采购商品 ID,来自商品列表。
data.statusstring是枚举 provisioning / active / expired / cancelled / failed当前状态;枚举见限制,按逐项结果确认终态。
data.ipstring是—实例实际 IP 地址。
data.portinteger是最小 0;格式 int64实例直连端口。
data.protocolsstring[]是—支持协议;实例列表为字符串数组,凭据响应为逗号分隔字符串。
data.countryCodestring是—国家三字码,例如 USA;使用国家目录返回值。
data.cityCodestring是—城市编码,使用城市目录返回值。
data.ispTypeinteger是最小 0;格式 int64IP 类型:1 原生IP,2 独享IP;与控制台销售类型一致。
data.expiresAtstring | null是格式 date-time实例到期时间,RFC3339;未知为 null。
data.activatedAtstring | null是格式 date-time实例激活时间,RFC3339;未激活为 null。
data.capabilitiesobject是—真实货源或实例能力;声明不替代提交时业务校验,缺失快照可为空对象。
data.capabilities.purchaseobject否—采购期限规则。
data.capabilities.purchase.allowedDaysinteger[]否—允许的期限天数集合;非空时优先采用该集合。
data.capabilities.purchase.minDaysinteger否最小 0无 allowedDays 集合时的最短期限。
data.capabilities.purchase.maxDaysinteger否最小 0最长期限,0 表示不设上限。
data.capabilities.purchase.stepDaysinteger否最小 0从最短期限起允许的增量天数。
data.capabilities.renewobject否—续费期限规则。
data.capabilities.renew.allowedDaysinteger[]否—允许的期限天数集合;非空时优先采用该集合。
data.capabilities.renew.minDaysinteger否最小 0无 allowedDays 集合时的最短期限。
data.capabilities.renew.maxDaysinteger否最小 0最长期限,0 表示不设上限。
data.capabilities.renew.stepDaysinteger否最小 0从最短期限起允许的增量天数。
data.capabilities.convertTrialobject否—试用转正式期限规则。
data.capabilities.convertTrial.allowedDaysinteger[]否—允许的期限天数集合;非空时优先采用该集合。
data.capabilities.convertTrial.minDaysinteger否最小 0无 allowedDays 集合时的最短期限。
data.capabilities.convertTrial.maxDaysinteger否最小 0最长期限,0 表示不设上限。
data.capabilities.convertTrial.stepDaysinteger否最小 0从最短期限起允许的增量天数。
data.capabilities.trialDaysinteger否最小 0试用期限天数;0 表示不提供试用。
data.capabilities.changeIpboolean否—是否支持换 IP。
data.capabilities.selectReplacementboolean否—是否支持选择替换节点。
data.capabilities.customCredentialsboolean否—是否支持客户指定账密。
data.capabilities.randomCredentialsboolean否—是否支持随机生成账密。
data.capabilities.maxBatchSizeinteger否最小 0货源能力声明的批量上限;服务端请求限制仍适用。
data.groupIdinteger | null是最小 1所属自定义分组 ID,未分组为 null;新实例默认未分组。
JSON · HTTP 200
{
  "code": 200,
  "message": "成功",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "data": {
    "instanceId": 101,
    "offerId": 17,
    "status": "active",
    "ip": "203.0.113.10",
    "port": 9000,
    "protocols": [
      "http",
      "socks5"
    ],
    "countryCode": "USA",
    "cityCode": "NYC",
    "ispType": 1,
    "expiresAt": "2026-10-06T08:00:00Z",
    "activatedAt": "2026-10-06T08:00:00Z",
    "capabilities": {
      "purchase": {
        "minDays": 30,
        "maxDays": 360,
        "stepDays": 30
      },
      "renew": {
        "allowedDays": [
          30
        ]
      },
      "convertTrial": {},
      "trialDays": 0,
      "changeIp": false,
      "selectReplacement": false,
      "customCredentials": true,
      "randomCredentials": true,
      "maxBatchSize": 100
    },
    "groupId": null
  }
}

错误与重试

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

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

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

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