StarKube

StarKube 云平台 API

直接答案：API 面向需要自动创建和管理实例、查询订单账单、接入工单流程或为直属客户办理实例退订的团队。调用时应妥善保存凭据，并遵循最小权限和审计原则。

StarKube API 文档覆盖 VPS 实例、订单、账单、工单、代理客户按天退订与实例流量查询。

API 面向需要自动创建和管理实例、查询订单账单、接入工单流程或为直属客户办理实例退订的团队。调用时应妥善保存凭据，并遵循最小权限和审计原则。

代理客户退订接口

管理员须在用户管理的代理配置中开启“支持退订”。代理先调用 GET /api/v1/agents/me/customers/{customerUserId}/instances/{vmId}/cancellation-preview，取得 paidAmount、termDays、usedDays、usedAmount 与 refundableAmount；确认后调用 POST /api/v1/agents/me/customers/{customerUserId}/instances/{vmId}/cancel。仅可操作直属客户的实例。

退订与退款规则

退订按已用自然日向上取整计费。平台会先销毁实例；销毁成功后才会取消服务订单，并将 refundableAmount 写入客户余额与退款账目。退款不会进入代理余额。重复退订、非直属客户或实例归属不符会返回业务错误。

代理客户实例流量查询

调用 GET /api/v1/agents/me/customers/{customerUserId}/instances/{vmId}/traffic?start=2026-07-05&end=2026-08-05&timezone=Asia%2FShanghai，可按包含结束日的消费周期查询 uploadBytes、downloadBytes、totalBytes、sampleCount 与 complete。流量查询只校验代理身份、直属客户关系和实例归属，不受客户退订权限开关影响。start 与 end 都不传时兼容返回当前累计值。

来源

常见问题

代理可以退订所有用户的实例吗？

不可以。接口仅允许已开启退订权限的代理操作直属客户，并会校验实例归属。

退订金额如何计算？

按服务周期内已使用的自然日向上取整计算已用费用，订单实付金额减去已用费用后，剩余金额返还至客户余额。

流量查询为什么返回 A403？

流量接口不使用退订权限开关。A403 表示代理身份、直属客户关系或实例归属校验未通过。