魔方云代理(WHMCS)-前台

获取订购页面配置

项目	内容
接口描述	获取订购页面配置
接口地址	/console/v1/product/:id/rewhmcs_cloud/order_page
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	商品ID

响应参数

name	type	default	desc
cycle	array	-	周期
pricing	object	-	商品价格
pricing.setupfee	string	-	一次性初装费
pricing.msetupfee	string	-	月初装费
pricing.qsetupfee	string	-	季初装费
pricing.ssetupfee	string	-	半年初装费
pricing.asetupfee	string	-	年初装费
pricing.bsetupfee	string	-	两年初装费
pricing.tsetupfee	string	-	三年初装费
pricing.onetime	string	-	一次性
pricing.monthly	string	-	月付
pricing.quarterly	string	-	季付
pricing.semiannually	string	-	半年付
pricing.annually	string	-	年付
pricing.biennially	string	-	两年付
pricing.triennially	string	-	三年付
configoption	array	-	配置
configoption[].id	int	-	配置项ID
configoption[].optionname	string	-	配置项名称
configoption[].firstname	string	-	配置项真实值
configoption[].lastname	string	-	配置项描述
configoption[].optiontype	string	-	配置项类型1下拉2单选3是否4数量
configoption[].qtyminimum	int	-	配置项最小值,类型为数量时才有
configoption[].qtymaximum	int	-	配置项最大值,类型为数量时才有
configoption[].options	array	-	配置子项
configoption[].options[].id	int	-	配置子项ID
configoption[].options[].optionname	string	-	配置子项名称
configoption[].options[].firstname	string	-	配置子项真实值
configoption[].options[].lastname	string	-	配置子项描述
configoption[].options[].currency	int	-	货币
configoption[].options[].setupfee	string	-	一次性初装费
configoption[].options[].msetupfee	string	-	月初装费
configoption[].options[].qsetupfee	string	-	季初装费
configoption[].options[].ssetupfee	string	-	半年初装费
configoption[].options[].asetupfee	string	-	年初装费
configoption[].options[].bsetupfee	string	-	两年初装费
configoption[].options[].tsetupfee	string	-	三年初装费
configoption[].options[].onetime	string	-	一次性
configoption[].options[].monthly	string	-	月付
configoption[].options[].quarterly	string	-	季付
configoption[].options[].semiannually	string	-	半年付
configoption[].options[].annually	string	-	年付
configoption[].options[].biennially	string	-	两年付
configoption[].options[].triennially	string	-	三年付
customfield	array	-	自定义字段
customfield[].id	int	-	自定义字段ID
customfield[].fieldname	string	-	自定义字段名称
customfield[].fieldtype	string	-	自定义字段类型text,textarea,tickbox,link,password,dropdown
customfield[].description	string	-	自定义字段描述
customfield[].fieldoptions	string	-	自定义字段选项,以,分隔
customfield[].regexpr	string	-	自定义字段验证规则
customfield[].required	string	-	是否必填on是

获取升降级配置

项目	内容
接口描述	获取升降级配置
接口地址	/console/v1/product/:id/rewhmcs_cloud/upgrade_page
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	商品ID

响应参数

name	type	default	desc
configoption	array	-	配置
configoption[].id	int	-	配置项ID
configoption[].optionname	string	-	配置项名称
configoption[].firstname	string	-	配置项真实值
configoption[].lastname	string	-	配置项描述
configoption[].optiontype	string	-	配置项类型1下拉2单选3是否4数量
configoption[].qtyminimum	int	-	配置项最小值,类型为数量时才有
configoption[].qtymaximum	int	-	配置项最大值,类型为数量时才有
configoption[].options	array	-	配置子项
configoption[].options[].id	int	-	配置子项ID
configoption[].options[].optionname	string	-	配置子项名称
configoption[].options[].firstname	string	-	配置子项真实值
configoption[].options[].lastname	string	-	配置子项描述
configoption[].options[].currency	int	-	货币

获取操作系统列表

项目	内容
接口描述	获取操作系统列表
接口地址	/console/v1/rewhmcs_cloud/:id/image
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

name	type	default	desc
list[].id	int	-	操作系统配置ID
list[].osid	string	-	操作系统ID
list[].name	string	-	操作系统名称

获取商品配置所有周期价格

项目	内容
接口描述	获取商品配置所有周期价格
接口地址	/console/v1/product/:id/rewhmcs_cloud/duration
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	商品ID
configoptions	object	-	-	配置项

响应参数

name	type	default	desc
[].name	string	-	周期名称
[].price	string	-	周期总价
[].discount	float	-	折扣(0=没有折扣)

产品列表

项目	内容
接口描述	产品列表
接口地址	/console/v1/rewhmcs_cloud
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
page	int	1	-	页数
limit	int	-	-	每页条数
orderby	string	-	-	排序(id,due_time,status)
sort	string	-	-	升/降序
keywords	string	-	-	关键字搜索:商品名称/产品名称/IP
country_id	int	-	-	搜索:国家ID
city	string	-	-	搜索:城市
area	string	-	-	搜索:区域
status	string	-	-	产品状态(Unpaid=未付款,Pending=开通中,Active=已开通,Suspended=已暂停,Deleted=已删除)
tab	string	-	-	状态using使用中expiring即将到期overdue已逾期deleted已删除

响应参数

name	type	default	desc
list	array	-	列表数据
list[].id	int	-	产品ID
list[].product_id	int	-	商品ID
list[].name	string	-	产品标识
list[].status	string	-	产品状态(Unpaid=未付款,Pending=开通中,Active=已开通,Suspended=已暂停,Deleted=已删除)
list[].active_time	int	-	开通时间
list[].due_time	int	-	到期时间
list[].client_notes	string	-	用户备注
list[].product_name	string	-	商品名称
list[].country	string	-	国家
list[].country_code	string	-	国家代码
list[].country_id	int	-	国家ID
list[].city	string	-	城市
list[].area	string	-	区域
list[].power_status	string	-	电源状态(on=开机,off=关机,operating=操作中,fault=故障)
list[].image_name	string	-	镜像名称
list[].image_icon	string	-	镜像图标(Windows,CentOS,Ubuntu,Debian,ESXi,XenServer,FreeBSD,Fedora,ArchLinux,Rocky,AlmaLinux,OpenEuler,RedHat,其他)
list[].ip_num	int	-	IP数量
list[].dedicate_ip	string	-	主IP
list[].assign_ip	string	-	附加IP(英文逗号分隔)
list[].self_defined_field	object	-	自定义字段值(键是自定义字段ID,值是填的内容)
list[].is_auto_renew	int	-	是否自动续费(0=否,1=是)
count	int	-	总条数
using_count	int	-	使用中产品数量
expiring_count	int	-	即将到期产品数量
overdue_count	int	-	已逾期产品数量
deleted_count	int	-	已删除产品数量
all_count	int	-	全部产品数量
data_center[].country_id	int	-	国家ID
data_center[].city	string	-	城市
data_center[].area	string	-	区域
data_center[].country_name	string	-	国家
data_center[].country_code	string	-	国家代码
self_defined_field[].id	int	-	自定义字段ID
self_defined_field[].field_name	string	-	自定义字段名称
self_defined_field[].field_type	string	-	字段类型(text=文本框,link=链接,password=密码,dropdown=下拉,tickbox=勾选框,textarea=文本区)

获取实例详情

项目	内容
接口描述	获取实例详情
接口地址	/console/v1/rewhmcs_cloud/:id
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	-	产品ID

响应参数

name	type	default	desc
host_data	object	-	产品数据
host_data.domain	string	-	产品标识
host_data.dedicatedip	string	-	独立IP
host_data.username	string	-	用户名
host_data.password	string	-	密码
host_data.productname	string	-	商品名称
host_data.bwusage	int	-	已用流量
host_data.bwlimit	int	-	流量限制
host_data.assignedips	array	-	附加IP
host_data.type	string	-	类型
host_data.reset_flow_day	int	-	流量重置时间
host_data.port	int	-	端口
host_data.rescue	int	-	救援系统0否1是
host_data.image_group_id	int	-	镜像分组ID
host_data.panel_pass	string	-	面板密码
host_data.configoptionsupgrade	int	-	支持升降级0否1是
config_options	array	-	产品配置
config_options[].option_type	int	-	配置类型
config_options[].sub_name	string	-	单位名称
config_options[].name	string	-	配置名称
configoptions	object	-	当前配置
configoptions.area.name	object	-	配置area对应的名称
configoptions.area.value	object	-	配置area对应的值
oldconfigoptions	object	-	当前配置ID对应的值,例如
customfields	object	-	自定义字段

开机

项目	内容
接口描述	开机
接口地址	/console/v1/rewhmcs_cloud/:id/on
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

无

关机

项目	内容
接口描述	关机
接口地址	/console/v1/rewhmcs_cloud/:id/off
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

无

重启

项目	内容
接口描述	重启
接口地址	/console/v1/rewhmcs_cloud/:id/reboot
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

无

强制关机

项目	内容
接口描述	强制关机
接口地址	/console/v1/rewhmcs_cloud/:id/hard_off
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

无

强制重启

项目	内容
接口描述	强制重启
接口地址	/console/v1/rewhmcs_cloud/:id/hard_reboot
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

无

批量操作

项目	内容
接口描述	批量操作
接口地址	/console/v1/rewhmcs_cloud/batch_operate
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	array	-	require	产品ID
action	string	-	require	动作on开机off关机reboot重启hard_off强制关机hard_reboot强制重启

响应参数

无

获取控制台地址

项目	内容
接口描述	获取控制台地址
接口地址	/console/v1/rewhmcs_cloud/:id/vnc
请求方式	POST
接口版本	v1

请求参数

无

响应参数

name	type	default	desc
data.url	string	-	控制台地址

控制台页面

项目	内容
接口描述	控制台页面
接口地址	/console/v1/rewhmcs_cloud/:id/vnc
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

无

获取实例状态

项目	内容
接口描述	获取实例状态
接口地址	/console/v1/rewhmcs_cloud/:id/status
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

name	type	default	desc
data.status	string	-	实例状态(pending=开通中,on=开机,off=关机,operating=操作中,fault=故障)
data.desc	string	-	实例状态描述

重置密码

项目	内容
接口描述	重置密码
接口地址	/console/v1/rewhmcs_cloud/:id/reset_password
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
password	string	-	require	新密码

响应参数

无

救援系统

项目	内容
接口描述	救援系统
接口地址	/console/v1/rewhmcs_cloud/:id/rescue
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
type	int	-	require	指定救援系统类型(1=windows,2=linux)
temp_pass	int	-	require	临时密码

响应参数

无

退出救援系统

项目	内容
接口描述	退出救援系统
接口地址	/console/v1/rewhmcs_cloud/:id/rescue/exit
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

无

重装系统

项目	内容
接口描述	重装系统
接口地址	/console/v1/rewhmcs_cloud/:id/reinstall
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
os	int	-	require	镜像ID
password	string	-	require	密码

响应参数

无

获取图表数据

项目	内容
接口描述	获取图表数据
接口地址	/console/v1/rewhmcs_cloud/:id/chart
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
start_time	int	-	-	开始秒级时间
type	string	-	require	图表类型(cpu=CPU,memory=内存,disk_io=硬盘IO,bw=带宽)

响应参数

name	type	default	desc
data.list	array	-	图表数据
data.list[].time	int	-	时间(秒级时间戳)
data.list[].value	float	-	CPU使用率
data.list[].total	int	-	总内存(单位:B)
data.list[].used	int	-	内存使用量(单位:B)
data.list[].read_bytes	float	-	读取速度(B/s)
data.list[].write_bytes	float	-	写入速度(B/s)
data.list[].read_iops	float	-	读取IOPS
data.list[].write_iops	float	-	写入IOPS
data.list[].in_bw	float	-	进带宽(bps)
data.list[].out_bw	float	-	出带宽(bps)

获取网络流量

项目	内容
接口描述	获取网络流量
接口地址	/console/v1/rewhmcs_cloud/:id/flow
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

name	type	default	desc
total	string	-总流量	-
used	string	-已用流量	-
leave	string	-	剩余流量
reset_flow_date	string	-	流量归零时间

获取网络流量总计

项目	内容
接口描述	获取网络流量总计
接口地址	/console/v1/rewhmcs_cloud/:id/flow_total
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID

响应参数

name	type	default	desc
bwlimit	int	-总流量(MB)	-
bwusage	int	-已用流量(MB)	-

快照列表

项目	内容
接口描述	快照列表
接口地址	/console/v1/rewhmcs_cloud/:id/snapshot
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
page	int	-	-	页数
limit	int	-	-	每页条数

响应参数

name	type	default	desc
data.list	array	-	列表数据
data.list[].id	int	-	快照ID
data.list[].name	string	-	快照名称
data.list[].create_time	int	-	创建时间
data.list[].remarks	string	-	备注
data.count	int	-	总条数

创建快照

项目	内容
接口描述	创建快照
接口地址	/console/v1/rewhmcs_cloud/:id/snapshot
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
remarks	int	-	require	备注
disk_id	int	-	require	磁盘ID

响应参数

无

快照还原

项目	内容
接口描述	快照还原
接口地址	/console/v1/rewhmcs_cloud/:id/snapshot/restore
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
snapshot_id	int	-	require	快照ID

响应参数

无

删除快照

项目	内容
接口描述	删除快照
接口地址	/console/v1/rewhmcs_cloud/:id/snapshot/:snapshot_id
请求方式	DELETE
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
snapshot_id	int	-	require	快照ID

响应参数

无

备份列表

项目	内容
接口描述	备份列表
接口地址	/console/v1/rewhmcs_cloud/:id/backup
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
page	int	-	-	页数
limit	int	-	-	每页条数

响应参数

name	type	default	desc
data.snapshots	array	-	列表数据
data.snapshots[].id	int	-	备份ID
data.snapshots[].name	string	-	备份名称
data.snapshots[].create_time	int	-	创建时间
data.snapshots[].remarks	string	-	备注
data.count	int	-	总条数

创建备份

项目	内容
接口描述	创建备份
接口地址	/console/v1/rewhmcs_cloud/:id/backup
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
remarks	int	-	require	备注
disk_id	int	-	require	磁盘ID

响应参数

无

备份还原

项目	内容
接口描述	备份还原
接口地址	/console/v1/rewhmcs_cloud/:id/backup/restore
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
backup_id	int	-	require	备份ID

响应参数

无

删除备份

项目	内容
接口描述	删除备份
接口地址	/console/v1/rewhmcs_cloud/:id/backup/:backup_id
请求方式	DELETE
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
backup_id	int	-	require	备份ID

响应参数

无

日志

项目	内容
接口描述	日志
接口地址	/console/v1/rewhmcs_cloud/:id/log
请求方式	GET
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	-	产品ID
keywords	string	-	-	关键字
page	int	-	-	页数
limit	int	-	-	每页条数
orderby	string	-	id,description,create_time,ip	排序
sort	string	-	asc,desc	升/降序

响应参数

name	type	default	desc
list	array	-	系统日志
list[].id	int	-	系统日志ID
list[].description	string	-	描述
list[].create_time	string	-	时间
list[].ip	int	-	IP
count	int	-	系统日志总数

计算产品配置升级价格

项目	内容
接口描述	计算产品配置升级价格
接口地址	/console/v1/rewhmcs_cloud/:id/common_config
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
configoptions	object	-	require	配置

响应参数

name	type	default	desc
price	string	-	价格
description	string	-	生成的订单描述

生成产品配置升级订单

项目	内容
接口描述	生成产品配置升级订单
接口地址	/console/v1/rewhmcs_cloud/:id/common_config/order
请求方式	POST
接口版本	v1

请求参数

name	type	default	validate	desc
id	int	-	require	产品ID
configoptions	object	-	require	配置

响应参数

name	type	default	desc
data.id	string	-	订单ID

验证下单

项目	内容
接口描述	验证下单
接口地址	/console/v1/product/:id/rewhmcs_cloud/validate_settle
请求方式	POST
接口版本	v1

请求参数

无

响应参数

无