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

静态 API 概览

查看静态住宅公开接口的认证、业务编号、异步结果、资金语义及逐接口文档。

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

静态 API 通过账户 API 令牌使用同一账户的钱包、订单、实例和客户价格。正式采购无需实名认证。是否可用以控制台实际状态为准。

接入约定

生产请求基址为 https://api.zzhttp.com/openapi/v1/static,接口前缀为 /openapi/v1/static,使用 HTTPS 和 统一 API 令牌认证。成功响应包含数字 code: 200、message、requestId 和 data;HTTP 200 可能表示交付成功、部分交付或已受理待确认,须读取 data.status。金额均为 CNY 整数分。分页默认第 1 页、每页 20 条,实例查询最多 1000 条(支持 500/1000),订单和操作查询最多 100 条;批量续费、凭据和分组移动最多 100 个实例。

采购使用 clientOrderNo,续费与改密使用 clientOperationNo。业务编号允许 1–64 位字母、数字、_、.、-,幂等范围是账户、操作类型与编号。同编号不同参数返回 HTTP 200 / 业务码 10705。网络超时先按原编号查询,不要更换编号重新发起。requestId 仅用于排障,不是幂等编号。API 开关关闭后不再接受新命令,已受理任务继续处理。

按功能查阅

下载静态 API OpenAPI 定义;下载 Python / Node.js 示例。

结果与资金

订单和收费操作返回 accepted、processing、succeeded、partial、failed 或 manual_review。以查询的逐项结果为准;通知可能重复、乱序,改密不发送结果通知。settlement 中原冻结金额等于当前冻结、已扣和已释放之和。钱包订单使用 fundingSource: wallet;查询历史直付订单时可能为 external,未付款或免费操作为 none。refundDueAmountCents 表示应退,不能当作已到账。manual_review 时应查看具体订单和资金状态,不要盲目重新购买。

错误码、HTTP 状态及恢复建议统一见错误码与处理建议。

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

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