VPS接口

1、购买VPS

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
pname	string	temai.vps.jichu(特卖VPS基础型) temai.vps.puji(特卖VPS普及型) temai.vps.jingji(特卖VPS经济型) temai.vps.haohua(特卖VPS豪华型)	产品名字
tid	int	1	购买交易id
input_name	int	0:Windows 1:Linux	操作系统类型，可选参数，默认是Windows
usetype	int		usetype说明详见注意事项4
yid	int	特卖vps(1,3,6,12,24,36)个月	购买年限
keytype	int	0(使用包销) 1(不使用) 默认为0	香港VPS可使用此参数

注意事项：

特卖VPS无包销 keytype参数仅对香港vps有效
特卖VPS 4-7级会员购买，1-3级不能购买
如果创业基金有余额，可以使用创业基金购买（针对特卖VPS）
usetype=0或不传，只使用创业基金(默认)
usetype=1，只使用快云币
usetype=2，先使用快云币；如果没有快云币则使用创业基金
usetype=3，先使用创业基金；如果没有创业基金则使用快云币
usetype=4，都不使用
注：创业基金和快云币不能同时使用

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<did>订单编号</did>
		<fund>创业基金</fund>
		<usekyb>快云币</usekyb>
	</info>
</result>

JSON返回值格式

{
	"code":"0" ,
	"info":
	{
		"did": 订单编号，
		"fund": 创业基金，
		"usekyb": 快云币
	}
}

2、开通VPS

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
did	int		订单编号
tid	int	2(开通)	交易id
mobile	手机号(可以不传)		安全手机号及管理者手机号
email	邮箱格式字符串(可以不传，但默认为代理的邮箱)	string	安全邮箱及管理者邮箱
applyname	管理者姓名(可以不传)	string	管理者姓名
input_name	int	该值可省略不传	重新选择系统
password	String	该值可省略不传（至少包含3个大写、3个小写、3个数字不允许包含特殊字符）	密码

注意：

 如果不传可能存在接收不到开通邮件，设置安全信息可能无法修改
 如果传入新的操作系统，那么开通的机器以此系统为准

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<bid>业务编号<bid>
		<ip>开通的IP地址</ip>
		<user>用户名</user>
		<pwd>密码<pwd>
		<createDate>开通时间</createDate>
		<overDate>到期时间</overDate>
		<remoteport>远程桌面端口号</remoteport>
		<servicePassword>服务密码</servicePassword>
		<serviceCode>服务码</serviceCode>
	</info>
</result>

JSON返回值格式

{
	"code":"0" ,
	"info":
	{
		"bid":业务编号，
		"ip": "开通的IP地址"，
		"user": "用户名"，
		"pwd": "密码”,
		"createDate":"开通时间”,
		"overDate":"到期时间”,
		"remoteport":"远程桌面端口号",
		"servicePassword":"服务密码",
		"serviceCode":"服务码"
	}
}

3、续费VPS

备注：VPS续费时，会把VPS的增值产品自动续费。默认续费1年

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
bid	int		业务编号
tid	int	3	交易id
usetype	int		详见购买VPS注意事项4
yid	int	香港vps(3,6,12)个月，特卖vps(1,3,6,12)个月	续费时间

注意事项：

如果创业基金有余额，可以使用创业基金续费（针对特卖VPS）

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<overDate>到期时间</overDate>
	</info>
</result>

JSON返回值格式

{
	"code"："0"
	"info":{
		"overDate":"到期时间"
		}
}

4、升级VPS

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
bid	int		业务编号
pname	string	temai.vps.puji(特卖VPS普及型) temai.vps.jingji(特卖VPS经济型) temai.vps.haohua(特卖VPS豪华型)	产品名称
tid	int	4	交易id

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
</result>

JSON返回值格式

{
	"code"："0"
}

5、获取VPS信息

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
bid	int		业务编号
tid	int	5	交易id

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<memorySize>内存大小</memorySize>
		<ipList>IP列表</ipList>
		<diskSize>硬盘大小</diskSize>
		<createDate>创建时间</createDate>
		<overDate>到期时间</overDate>
		<user>系统用户名</user>
		<pwd>系统密码</pwd>
		<bid>业务编号</bid>
		<remoteport>远程桌面端口</remoteport>
	</info>
</result>

JSON返回值格式

{
	"code"："0"
	info"：
	{
		"memorySize":"内存大小",
		"ipList":"IP列表",
		"diskSize":硬盘大小"，
		"createDate":"创建时间",
		"overDate":"到期时间",
		"user":系统用户名"，
		"pwd":"系统密码",
		"bid":"业务编号",
		"remoteport":远程桌面端口"
	}
}

6、通过订单ID获取业务ID

备注：只有新增并开通过业务的订单才能获取业务ID

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
did	int		订单编号
tid	int	7	交易id

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
	    <bid>业务编号</bid>
	    <ptype>产品类型</ptype>
  </info>
</result>

JSON返回值格式

{
	"code"："0",
	”bid”: 业务编号
	"ptype”:产品类型
}

7、增值交易

备注：默认增值时长为当前时间到主业务的到期时间。

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
bid	int		业务编号
pname	string	temai.zengzhi.neicun（增值内存） temai.zengzhi.yingpan(增值硬盘) temai.zengzhi.ip(增值ip)	内存大小(MB单位)依次递增1024MB 硬盘大小(GB)依次递增10G IP每次只能增值一个,size参数对IP增值无效
size	int		增值大小
tid	int	8	交易id

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
</result>

JSON返回值格式

{
	"code"："0"
}

8、通过业务ID获取增值信息

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
bid	int		业务编号
tid	int	9	交易id

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<node>
			<type>增值类型</type>
			<date>增值时间</date>
			<size>增值大小或者增值IP </size>
		</node>
	</info>
</result>

JSON返回值格式

{
	"code":0,
	"info":
		[
			{
			"type":"增值类型",
			"date":"增值时间",
			"size":"增值大小或者增值IP"
			}
		]
}

9、申请免费试用

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
pname	string	temai.vps.jichu(特卖VPS基础型) temai.vps.puji(特卖VPS普及型) temai.vps.jingji(特卖VPS经济型) temai.vps.haohua(特卖VPS豪华型)	产品名字
input_name	int	0:Windows 1:Linux	操作系统类型，可选参数，默认是Windows
tid	int	10	交易id

注意事项：

特卖VPS 6-7级会员可以无限次数试用，1-5级不能试用

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<did>订单编号</did>
	</info>
</result>

JSON返回值格式

{
	"code":"0" ,
	"info":
	{
		"did": 订单编号
	}
}

10、转正交易

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
bid	int	11	业务编号
yid	int	特卖vps(1,3,6,12)个月	购买期限
tid	int	11	交易id

注意事项：

-如果创业基金有余额，优先使用创业基金转正（针对特卖VPS）

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<createDate>开通时间</createDate >
		<overDate>到期时间</overDate>
		<ywbh>业务编号</ywbh>
		<ywbs>业务标识</ywbs>
	</info>
</result>

JSON返回值格式

{
	"code":"0" ,
	"info":
	{
		"createDate":"开通时间",
		"overDate":"到期时间"
	}
}

11、业务信息同步

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
bid	int		业务编号
tid	int	18	交易id

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		 <addValue>增值信息，无增值信息业务无此节点
			<appName>temai.zengzhi.ip(与产品增值方法，增值产品名称一样)</appName>
			<appSize>增值大小</appSize>
			<appUnit>增值单位，没有增值单位的为‘无’</appUnit>
			<appDate>增值时间</appDate>
			<appTimeLimit>增值期限单位：月</appTimeLimit>
			<ip>IP地址</ip>
		 </addValue>
		 <config>配置信息
		      <harDisk>硬盘大小</harDisk>
		      <pname>产品名称</pname>
		      <bid>业务编号</bid>
		      <memory>内存大小</memory>
		      <ip>IP地址</ip>
		 </config>
		 <Extir>业务信息
		      <overDate>到期时间</overDate>
		      <osType>系统类型</osType>
		      <createDate>开通时间</createDate>
		      <productName>产品名称</productName>
		      <bid>业务编号</bid>
		      <areaCode>地区编号（4001:郑州4002：香港4003：北京）</areaCode>
		      <status>业务状态0：试用1：正常2：过期</status>
		      <serviceTime>服务期限，单位为月</serviceTime>
		      <userName>VPS管理用户名</userName>
		      <password>系统密码</password>
		      <remoteport>远程桌面端口</remoteport>
		      <vpslx>vps类型</vpslx>
		      <did>订单号</did>
		      <cpbh>产品编号</cpbh>
		      <ptype>产品类型</ptype>
		      <ip>IP地址</ip>
		      <nwip>内网IP</nwip>	      
		 </Extir>
		 <ipv6>
			<node>2400:A480:000F:0040:0065:0000:0000:0204</node>
			<node>2400:A480:000F:0040:0065:0000:0000:0304</node>
			<node>2400:A480:000F:0040:0065:0000:0000:0404</node>
			<node>2400:A480:000F:0040:0065:0000:0000:0504</node>
	         </ipv6>
		<identification>
			<authentication>false(未认证)true(已认证)</authentication>
		</identification>	 
	</info>
</result>

JSON返回值格式

{
	"code":"0" ,
	"info":
	{
		 "addValue": [增值信息，无增值信息业务无此节点
				      {
					"appName": "zengzhi.ip",增值产品名称
					"appSize": 1,增值大小
					"appUnit": "个",增值单位没有则为‘无’
					"appDate": "2011-08-13 09:28:27",增值时间
					"appTimeLimit": 10,增值期限
					"ip": "192.168.100.171"IP地址
							      },
				      {
					"appName": "zengzhi.ip",
					"appSize": 1,
					"appUnit": "无",
					"appDate": "2012-04-28 14:19:37",
					"appTimeLimit": 12,
					"ip": "192.168.100.171"
				      }
			  ],
		"config": {配置信息
					"harDisk": 40,硬盘大小
					"pname": "fast.cloudvps.puji",所属业务产品名称
					"bid": 1, 所属业务编号
					"memory": 512,内存大小
					"ip": "192.168.100.171"IP地址
				       },    
		"Extir": {业务信息
					"overDate": "2018-11-29 17:58:55",到期时间
					"osType": "windows 2003",系统类型
					"createDate": "2013-11-27 17:58:52",开通时间
					"productName": "fast.cloudvps.puji",产品名称
					"bid": 1, 业务编号
					"ip": "192.168.100.171"IP地址
					"areaCode":地区编号,（4001:郑州4002：香港4003：北京）
					"status":业务状态,0：试用1：正常2：过期
					"serviceTime":服务期限，单位为月
					"userName":VPS管理用户名
					"password": 系统密码
					"remoteport": 远程桌面端口
					"vpslx": vps类型
					"did": 订单号
					"cpbh": 产品编号
					"ptype": 产品类型
					"nwip":内网ip
				    },
		"identification":{"authentication":"false"}
		"ipv6":[
			"2400:A480:000F:0040:0065:0000:0000:0204",
			"2400:A480:000F:0040:0065:0000:0000:0205",
			]
			

	}
}

12、获取VPS所有编号

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
tid	int	20	交易id

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<bh>业务编号</bh>
	</info>
</result>

JSON返回值格式

{
	"code"："0"
	"info":{
		"bh":"业务编号"
		}
}

13、VPS临时增值

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
tid	int	40	交易id
bid	int		业务编号
yid	int		增值时长(天)
disk	int		硬盘大小(G)
bandwidth	int		带宽(M)
pname	string		增值名称

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<use_QC_coin>所用快云币</use_QC_coin>
	</info>
</result>

JSON返回值格式

{
	"code"："0"
	"info":{
		"use_QC_coin":"所用快云币"
		}
}

14、测试码开通vps

参数	参数类型	参数值	参数描述
ptype	string	vps	产品类型
did	int		订单号
testCode	string		测试码
tid	int	50	交易id
email	string	邮箱格式字符串(可以不传，但默认为代理的邮箱)	安全邮箱及管理者邮箱
input_name	int	该值可省略不传	重新选择系统

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<bid>业务编号<bid>
		<ip>开通的IP地址</ip>
		<user>用户名</user>
		<pwd>密码<pwd>
		<createDate>开通时间</createDate>
		<overDate>到期时间</overDate>
                <remoteport>远程桌面端口号</remoteport>
	</info>
</result>

JSON返回值格式

{
	"code":"0" ,
	"info":
	{
		"bid":业务编号，
		"ip": "开通的IP地址"，
		"user": "用户名"，
		"pwd": "密码”,
		"createDate":"开通时间”,
		"overDate":"到期时间”,
                "remoteport":"远程桌面端口号"
	}
}

15、检验包销订单数量

参数	参数类型	参数值	参数描述
ptype	string	self	产品类型
tid	int	38	交易id
yid	int	包销订单的购买期限	购买期限
input_name	string	fastcloudvps或hkhost	产品类型
pname	string	快云VPS的pname	产品名称

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<bxsum>20</bxsum>
	</info>
</result>

JSON返回值格式

{
	"code":"0" ,
	"info":
	{
		"bxsum":20
	}
}

16、获取VPS操作系统类型

参数	参数类型	参数值	参数描述
ptype	string	fastcloudvps	产品类型
tid	int	56	交易id
pname	string	vps产品名称（input_name为fastcloudvps时必选）	产品名称
input_name	string	vps或fastcloudvps	产品类型

注意：

快云VPS基础型没有windows2008，如果要获取请传入pname参数
返回参数0，1，2 代表系统参数  Linux或WindowsXXXX代表系统描述

XML返回值格式

<? XML version="1.0" encoding="UTF-8" ?>
<result>
	<code>0</code>
	<info>
		<0>windows2003</0>
		<1>Linux</1>
	</info>
</result>

JSON返回值格式

{"code":0,"info":{"1":"Linux","0":"windows2003"}}

景安API接口wiki

用户工具

站点工具

侧边栏

目录

VPS接口

1、购买VPS

XML返回值格式

JSON返回值格式

2、开通VPS

XML返回值格式

JSON返回值格式

3、续费VPS

XML返回值格式

JSON返回值格式

4、升级VPS

XML返回值格式

JSON返回值格式

5、获取VPS信息

XML返回值格式

JSON返回值格式

6、通过订单ID获取业务ID

XML返回值格式

JSON返回值格式

7、增值交易

XML返回值格式

JSON返回值格式

8、通过业务ID获取增值信息

XML返回值格式

JSON返回值格式

9、申请免费试用

XML返回值格式

JSON返回值格式

10、转正交易

XML返回值格式

JSON返回值格式

11、业务信息同步

XML返回值格式

JSON返回值格式

12、获取VPS所有编号

XML返回值格式

JSON返回值格式

13、VPS临时增值

XML返回值格式

JSON返回值格式

14、测试码开通vps

XML返回值格式

JSON返回值格式

15、检验包销订单数量

XML返回值格式

JSON返回值格式

16、获取VPS操作系统类型

XML返回值格式

JSON返回值格式

页面工具