1. 接入文档
智星云开放接口
  • OpenAPI v2
    • 开始使用
    • 更新日志
    • 常见问题Q&A
    • 产品文档
      • 关于计费
      • 关于实例
      • 关于租用
      • 实例访问
      • 实例状态
      • 实例费用
    • 接入文档
      • 接口约定
      • 接口签名
      • 接口顺序
      • 参考代码(Golang版)
      • 参考代码(Python3版)
      • 参考代码(Java版)
      • 签名调试工具
        POST
    • 1.0 账号模块
      • 1.1 获取apikey信息
      • 1.2 获取主账户信息
    • 2.0 算力市场(租用市场)
      • 如何接入CPU和云主机实例租用
      • 旧接口如何迁移至按实例规格租用
      • 2.1 算力列表展示页
        • 获取云主机租用选项
        • 获取基础配置项
        • 获取价格信息
        • 获取实例规格列表(CPU租用和GPU租用均适用)
      • 2.2 租用确认页
        • 查询GPU相关信息
        • 查询CPU内存规格信息
        • 查询镜像详细信息
        • 创建云主机询价
        • 查询云主机库存调度状态
        • 创建云主机
    • 3.0 自主实例
      • 3.1 实例信息
        • 获取实例状态统计
        • 获取自主实例列表
        • 获取自主实例详情
        • 获取web端访问vnc和ssh的链接
        • 获取windows远程访问rdp文件
        • 获取屏幕截图(截屏)
      • 3.2 实例费用
        • 获取自主实例费用汇总
        • 获取自主实例费用明细
      • 3.3 变更实例
        • 修改实例到期处理模式
        • 修改实例访问密码(改密码)
      • 3.4 实例续费&退费
        • 手动续费实例询价
        • 手动续费实例
        • 设置实例自动续费
        • 实例启动错误,手动退费
        • 提前退租询价
        • 提前退租(退款至算力券账户)
      • 3.5 实例升级&扩容
        • 旧接口(待废弃)
          • 查询资源池剩余CPU
          • 添加CPU
          • 查询资源池剩余内存
          • 添加内存
        • 升级实例规格/CPU/内存
          • 获取升级规格选项
          • 升级规格询价
          • 升级规格
        • 修改实例带宽询价
        • 修改实例带宽
        • 查询资源池剩余磁盘
        • 添加磁盘询价
        • 添加磁盘
      • 3.6 实例迁移
        • 获取迁移条件(迁移检查)
        • 一键迁移实例
      • 3.7 实例捞回
        • 捞回条件检查并询价
        • 捞回实例
      • 3.8 重置系统
        • 获取本地可用镜像
        • 重置系统
      • 3.9 重启实例
        • 从保留磁盘创建实例(会将磁盘重启为新实例)
        • 从保留磁盘创建实例询价
        • 重启实例(将实例关机&开机)
        • 启动实例(关机状态下开机)
      • 3.10 其他
        • 释放保留的磁盘
        • 修改实例备注
    • 4.0 自定义镜像
      • 4.1 制作镜像-准备过程
        • 获取创建镜像可用的实例列表
        • 挂起实例
        • 恢复挂起实例
      • 4.2 创建镜像
        • 创建自定义镜像-询价
        • 从实例创建自定义镜像
      • 4.3 自定义镜像列表
        • 获取用户自定义镜像列表
        • 更新镜像信息
        • 获取引用该镜像的实例列表
        • 获取镜像扣费明细
      • 4.4 镜像续订
        • 镜像续费询价
        • 镜像续费
      • 4.5 提前退订
        • 镜像提前退租退款询价
        • 镜像提前退租退款并删除
      • 4.6 创建失败
        • 镜像创建失败退款
        • 镜像创建失败重试
      • 获取镜像详情
    • 5.0 账单模块
      • 获取充值订单列表
      • 获取余额变更明细
    • 6.0 共享盘(AI模型库)
      • 共享盘(AI模型库)接口接入参考
      • 是否有新共享盘
      • 获取共享盘列表
      • 获取共享盘详情
      • 挂载共享盘询价
      • 挂载共享盘
      • 卸载共享盘询价(退费)
      • 卸载共享盘
    • 其他模块
      • 合同实例(仅获取)
        • 获取合同实例列表
        • 获取合同实例详情
        • 获取合同实例费用明细
      • 获取子账号列表
  1. 接入文档

接口签名

整体方法采用:timestamp+nonce+sign方案,可防止请求被修改、请求被重放。

请求字段#

参数名字段说明字段类型是否必传值案例
apikeyaccessKeystring是8b90cf872569460a
timestamp时间戳integer是1733814154
nonce随机数string是CrpsYHp
sign签名值string是664ea273d9af09636524925e785f4f71
param1参数1string否iamcoolman
param2参数2integer否18
param3参数3bool否true
param4参数4string否""

字段说明#

apikey,是请求身份凭证,在 开始使用->信息准备 页面中,有获取说明。
timestamp,是请求的时间戳整数,单位是秒(请保证服务器的时间准确,可使用chrony定期同步服务器时间,否则请求会被拒绝)。
nonce,是随机字符串,防止重复,推荐使用8位以上的随机串(一定时间内的重复随机串的请求将不被通过)。
sign,是请求参数签名,见下方逻辑生成。

生成签名#

假设业务需要提交的请求参数有:param1=iamcoolman,param2=18,param3=true,param4=,其中param4的参数值为空字符串
那么最终实际需要提交的参数名包括:apikey,timestamp,nonce,param1,param2,param3,sign
其中apikey,timestamp,nonce参数的说明见上方表格,sign参数值的生成见下方:
1.
按照请求参数名的字母升序排列非空请求参数(包含apikey) :stringA="apikey=8b90cf872569460a&nonce=CrpsYHp&param1=iamcoolman&param2=18&param3=true&timestamp=1733814154"; (注意param4的值为空,所以不参与签名)
2.
拼接密钥secret:stringSignTemp=stringA+"&secret={你申请的SecretKey}"; (注意 secret=xxxx 是不参与排序的,是直接在末尾拼接即可)
3.
取MD5得到sign的值:sign=MD5(stringSignTemp);
4.
将生成的 sign 参数添加到请求参数中(post请求放入body)。
文章参考:保证接口安全性,开放 HTTP API 接口签名验证! - 知乎
修改于 2025-06-05 07:26:05
上一页
接口约定
下一页
接口顺序
Built with