添加分组

请求方法

POST

请求地址

/rooms/groups

请求参数

请求参数	参数类型	数据类型	是否必须	描述
name	Body	String	是	会议室分组名称
locationType	Body	Integer	是	位置类型，0：默认，1：未分配地点(不允许添加)，2：建筑，3：楼层
parentId	Body	String	否	父分组id，若未填写则默认在根分组下
description	Body	String	否	指分组简介，非必填，文本形式不限，最大支持输入256个字符；

HTTP状态码

返回值	描述
200	操作成功，详见响应参数
400	客户端传参异常
401	鉴权失败
500	服务端异常

响应参数

参数	数据类型	描述
id	String	分组id

请求消息示例

POST /open/api/v2/rooms/groups HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

{
	"name":"group1",
	"locationType": 3,
	"parentId":"794bebaa552247f3b29774ace2ab637d",
	"description": ""
}

响应消息示例

HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8

{
    "id": "b9cbe767e9d34117af752f57aa399652"
}

CURL命令示例

curl -XPOST -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'Content-Type: application/json' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -d '{
	"name":"group1",
	"locationType": 3,
	"parentId":"794bebaa552247f3b29774ace2ab637d",
	"description": ""
}' 'https://api.yealink.com/open/api/v2/rooms/groups'