【TcaplusDB知识库】如何在游戏区增加zone
请求地址
POST
http://OmsAddress/app/newoms.php/webservice/business/zones/add?cmd=10006&ip-type=webservicerest&access-token=AccessTokenValPOST请求参数说明
参数名称 | 数据类型 | 说明 | 是否必填字段 | 备注 |
set_id | 整型 | 游戏区所在的集群的id | 是 | |
app_id | 整型 | zone所在的业务的id | 是 | |
zone_id | 整型 | 游戏区的id | 是 | |
zone_group | 字符串 | 游戏区分组 | ||
zone_name | 字符串 | 游戏区名称，最大长度为63 | ||
zone_tag | 字符串 | 游戏区标签列表，由游戏区标签用分号";"拼接所得，不能超过5个游戏区标签 其中，每个游戏区标签只能包含汉字、英文字母、数字、下划线，最大长度为64 |
Data参数
使用json格式表示记录相关信息，示例如下：
{
"set_id": 126,
"app_id": 2,
"zone_id": 1005,
"zone_name": "test_add_zone",
"zone_group": "group name",
"zone_tag": "tag1;tag2;tag3;tag4;tag5;"
}返回语法
返回参数说明
- 返回状态码不为200时，表示添加zone失败，返回数据为错误信息
- 返回状态码为200，表示zone添加成功，返回的为添加的zone的信息
请求示例
通过 curl 方法发起请求
命令中的红色部分是需要用户自行填写的参数，请参阅url中GET参数说明
curl -H "Content-type: application/json" -X "POST" -d '{
"set_id": 126,
"app_id": 2,
"zone_id": 1005,
"zone_name": "test_add_zone",
"zone_group": "group name",
"zone_tag": "tag1;tag2;tag3;tag4;tag5;"
}' http://omsaddress/app/newoms.php/webservice/business/zones/add?cmd=10006&ip-type=webservicerest&access-token=<access-token>
返回示例
成功返回示例
http请求的Status=200
{
"set_id": 126,
"trans_id": 411
}错误返回
http请求的Status!=200
{
"name": "Unauthorized",
"message": "You are requesting with an invalid credential.",
"code": 0,
"status": 401,
"type": "yii\\web UnauthorizedHttpException"
}
{
"set_id": 126,
"app_id": 2,
"zone_id": 1005,
"zone_name": "test_add_zone",
"zone_group": "Normal",
"zone_tag": "tag1;tag2;tag3;tag4;tag5",
"create_date": "2017-03-03 11:56:55",
"uid": 172
}
TcaplusDB是腾讯出品的分布式NoSQL数据库，存储和调度的代码完全自研。具备缓存+落地融合架构、PB级存储、毫秒级时延、无损水平扩展和复杂数据结构等特性。同时具备丰富的生态、便捷的迁移、极低的运维成本和五个九高可用等特点。客户覆盖游戏、互联网、政务、金融、制造和物联网等领域。
