创建新分区

应用场景

该接口可供第三方自动开区工具等,创建一个新的分区。

一个分区只能拥有一个比例模版,但是可以拥有多个分组

接口链接

请求方式:只支持POST

URL地址:https://www.x7pay.net/api/addpartition.html

请求参数

字段名 变量名 必填 类型 示例值 描述
账户APIKEY apiKey String E0FB187A9A22D4F3CBCCEA58072A2DA7 小七充值平台分配给商户的apiKey,32位长度,是调用api的基本凭证
分区名称 partitionName String 热血传说四区(编码后:%E7%83%AD%E8%A1%80%E4%BC%A0%E8%AF%B4%E5%9B%9B%E5%8C%BA) 分区名称,50个字符或汉字以内,使用UrlEncode(UTF-8)编码,可参考编码/解码工具
服务器IP serverIp String 111.2.3.4 该分区所在的服务器IP
充值网关端口 serverPort Int 7788 服务器上运行的充值网关的端口
分区路径 serverPath String D:\MirServer(编码后:D%3A%5CMirServer) 该分区所对应的服务端目录路径,使用UrlEncode(UTF-8)编码,可参考编码/解码工具
模版ID modelId Int 234 模版的唯一标识ID
分组ID集合 groupIds String 123,234,345 分组ID集合,多个分组ID间用小写逗号隔开
分区显示时间 showTime String 20180101123000 该分区在“分组充值页面”上显示的时间,显示后用户才能看见,从而点击充值。不传该字段时默认值为当前时间,时间格式yyyyMMddhhmmss
正式开区时间(新增) openTime String 20180101123000 设置正式区开区时间,平台将根据此时间杜绝玩家卡时间充值,避免玩家开区领取双份充值。不传该字段时默认值为空,时间格式yyyyMMddhhmmss
是否开启元宝蛋 isOpenYbd Int 2 是否开启元宝蛋功能,1为是,2为否,不传该字段时默认值为2
是否加载分区脚本 isLoad Int 1 是否加载分区脚本,1为是,2为否,不传该字段时默认值为1
是否定时修改分区名称 isAutoUpdate Int 2 是否在指定时间自动修改分区名称,1为是,2为否,不传该字段时默认值为2
定时修改分区名称的时间 autoUpdateTime String 20180101133000 定时修改分区名称的时间,isAutoUpdate=1时,该字段为必传,时间格式yyyyMMddhhmmss
定时修改后的分区名称 autoUpdateName String 热血传说一区正式开放 定时修改后的分区名称,50个字符或汉字以内,isAutoUpdate=1时,该字段为必传,使用UrlEncode(UTF-8)编码,可参考编码/解码工具

举例如下:

https://www.x7pay.net/api/addpartition.html?apiKey=abc&partitionName=%E7%83%AD%E8%A1%80%E4%BC%A0%E8%AF%B4%E5%9B%9B%E5%8C%BA&serverIp=111.2.3.4&serverPort=8899&serverPath=D%3A%5CMirServer&modelId=1234&groupIds=234,345,456&isOpenYbd=2&showTime=20180101133000&isAutoUpdate=1&autoUpdateTime=20180101133000&autoUpdateName=%E7%83%AD%E8%A1%80%E4%BC%A0%E8%AF%B4%E4%B8%80%E5%8C%BA%E6%AD%A3%E5%BC%8F%E5%BC%80%E6%94%BE

返回结果

字段名 变量名 必填 类型 示例值 描述
业务状态码 resultCode Int 200

200/201/500

此字段是业务标识状态码,200代表业务处理成功,并成功返回(此接口的成功,仅代表分区创建成功,不一定代表脚本加载成功)

业务状态描述 message String 成功

当resultCode非200时返回信息为错误原因 ,例如

apiKey不存在

数据集 Data String

当resultCode为200时,数据会装入该字段一并返回

Data内的id字段 id Int 12345

分区创建成功后,该分区的唯一id

举例如下:

{
    "resultCode": 200,
    "message": "分区创建成功,网关通讯失败,错误码:,网关服务器连接失败",
    "Data": {
        "id": 12345
    }
}

状态码

状态码 描述
200 成功
201 业务错误,具体错误信息请参照message字段
500 系统错误

常用工具