创建静态 IP 分组
创建本人单层分组，名称 trim 后 1–50 个字符，同账户重名返回 400 / 10700。不支持删除、改名或多级分组。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
POST
/openapi/v1/static/groups创建本人单层分组，名称 trim 后 1–50 个字符，同账户重名返回 400 / 10700。不支持删除、改名或多级分组。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据，仅说明结构。接口合同不代表目标环境已开放，开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌，在受控服务端保存；示例使用占位符。 |
请求示例 · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
name | string | 是 | 最短 1 | 名称去除首尾空白后 1–50 个字符，账户内不得重复；长度以 Unicode 字符计。 |
请求示例
curl --request POST \
"https://api.zzhttp.com/openapi/v1/static/groups?api_key=${STATIC_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"name":"Work"}'成功响应
成功
响应不包含代理密码，凭据仅由专用接口返回。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 200 | 统一数字业务码：HTTP 与业务码成功均为 200；异步受理不代表交付完成。 |
message | string | 是 | — | 服务端结果说明。 |
requestId | string | 是 | — | 本次请求的追踪 ID，用于排障，不是业务幂等编号。 |
data | object | 是 | — | 本接口业务数据。 |
data.groupId | integer | 是 | 最小 1 | 分组 ID。 |
data.name | string | 是 | — | 自定义分组名称。 |
data.createdAt | string | 是 | 格式 date-time | 创建时间，RFC3339。 |
data.updatedAt | string | 是 | 格式 date-time | 最后更新时间，RFC3339。 |
{
"code": 200,
"message": "成功",
"requestId": "00000000-0000-4000-8000-000000000001",
"data": {
"groupId": 12,
"name": "Work",
"createdAt": "2026-10-06T08:00:00Z",
"updatedAt": "2026-10-06T08:00:00Z"
}
}错误与重试
读取请求遇到 429 按 Retry-After 等待；500/503 可有限重试。分组创建结果不明时先查询分组列表；移动同一目标可安全重试。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗？
反馈只用于改进公开文档，不会提交账号或请求信息。