【TcaplusDB知識庫】如何在遊戲區增加zone
阿新 • • 發佈:2022-03-14
請求地址
POST
http://OmsAddress/app/newoms.php/webservice/business/zones/add?cmd=10006&ip-type=webservicerest&access-token=AccessTokenVal
POST請求引數說明
引數名稱 | 資料型別 | 說明 | 是否必填欄位 | 備註 |
---|---|---|---|---|
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 方法發起請求
命令中的紅色部分是需要使用者自行填寫的引數,請參閱
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
}