开通代理

请求路径

/api/open/app/instance/open/v2

请求参数

主接口中的params参数

参数	二级参数	三级参数	类型	必填	说明
appOrderNo	-	-	string(32)	是	购买者订单号(渠道商订单号),同一个订单保持唯一，我方或作幂等性检查
params	-	-	array	是	购买代理产品列表
-	productNo	-	string	是	商品编号，推荐👍（按商品编号购买的时候，后面7项商品筛选条件无意义）→着重看下面红色部分备注
-	proxyType	-	uint16	否	(1) 代理类型，详见字典
-	countryCode	-	string	否	(2) 国家代码
-	cityCode	-	string	否	(3) 城市代码
-	supplierCode	-	string	否	(4) 供应商代码（可为null,随机分配）
-	unit	-	int8	否	(5) 单位 1=天 2=周(7天) 3=月(自然月) 4=年(自然年365，366) 10=无限制
-	ispType	-	int	否	(6) isp类型 1=单isp 2=双isp
-	duration	-	int32	是	(7) 产品定义的时长单位
-	count	-	int	是	购买数量（实例个数）静态必填默认1 一次最大20
-	cycleTimes	-	int32	是	购买时长周期数，此字段对有时长的产品有意义，默认1表示产品的duration个unit的时长,详见 →备注
-	renew	-	bool	否	是否续费 1续费默认0
-	extBandWidth	-	int32	否	额外增加带宽单位Mbps
-	appUsername	-	string	否	主账号，开通动态代理的时候必填(必须在平台上注册过)
-	flow	-	int	是	动态流量，静态的字段无意义动态必填单位MB
-	useBridge	-	uint8	否	1=不使用桥 2=使用桥不传跟随app设置默认
-	projectId	-	string	否	购买项目id,保留字段，后续会支持
-	cidrBlocks	-	array	否	支持网段及数量
-	-	cidr	string	否	网段 192.168.0.0/24 172.16.0.0/16 10.0.0.0/8
-	-	count	int	否	该网段数量

eg

{
    "appOrderNo":"TEST20240726094927",
    "params":[
        {
            "productNo":"ipideash_598",
            "count":20,
            "cycleTimes":1
        },
        {
            "productNo":"mb_gmhd5exp2",
            "count":20,
            "cycleTimes":12
        }
    ]
}

备注：

cycleTimes 为新增字段，以区分产品的duration字段，老版本使用的duration，会自动兼容，新的对接方式请使用cycleTimes字段

产品购买分为按产品编号（productNo）唯一指定的产品和按产品筛选条件（proxyType,countryCode,cityCode,supplierCode,ispType,duration,unit）购买。当产品编号存在时，产品筛选条件不起作用（我们推荐按产品编号购买，这是唯一的，价格确定的，如果存在号段，也可以指定购买的号段）。

按筛选条件购买时，筛选条件越多，产品会越少，因为找不到产品，而购买失败。而且不能号段筛选（所以不建议用这种形式）

购买数量（count）和购买周期数（cycleTimes）必填，不填默认为1，购买一条一个时间周期

备注：产品列表的时长：duration 和单位：unit的结合，代表这款产品的最小时长

eg：

duration=1 unit=1 表示最少按1天卖如果购买参数cycleTimes=1 表示购买1天 cycleTimes=30代表30天
duration=1 unit=3 表示最少按1月卖如果购买参数cycleTimes=1 表示购买1月 cycleTimes=12代表12月，3代表自然月，根据购买当月的天数计算，比如2月可能28天或者29，3月31天，4月30天
duration=30 unit=1 表示最少按30天卖如果购买参数cycleTimes=1 表示购买30天 cycleTimes=12代表360天
duration=1 unit=4 表示最少按1年卖如果购买参数cycleTimes=1 表示购买1年，即365天或者366天

费用计算

静态产品的费用 = 产品价格 * cycleTimes * count+ 带宽价格 * extBandWidth * cycleTimes * count+使用桥费用 * cycleTimes * count

带宽价格
- 必须产品支持，extBandWidth为0，表示为默认带宽,无费用
桥（高速通道）
- 必须实名认证企业可用
- 如果useBridge = 1 不会产生桥费用，如果不传，跟随app，app配置为使用桥，购买海外产品（包含香港，台湾）就会使用桥
- 桥使用需要先获取桥地址动态

流量产品的费用 = 产品价格（MB）* flow

流量产品count 不起作用

流量产品只对flow起作用

返回数据

参数	二级参数	类型	必填	说明
orderNo	-	string	是	平台订单号
appOrderNo	-	string	是	购买者订单号(渠道商订单号) 原样返回号
amount	-	string	否	花费金额（总共花费金额）