差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
im:server:basics:live_draft [2018/11/22 10:11] jk |
im:server:basics:live_draft [2018/11/22 11:14] jk |
||
---|---|---|---|
行 279: | 行 279: | ||
^参数^说明^ | ^参数^说明^ | ||
|max_users|Integer类型, 直播间最大人数| | |max_users|Integer类型, 直播间最大人数| | ||
- | |max_users|Integer类型, 直播间最大人数| | + | |custom|String类型,用户自定义字段| |
- | |max_users|Integer类型, 直播间最大人数| | + | |title|String类型, 标题| |
- | |max_users|Integer类型, 直播间最大人数| | + | |desc|String类型, 描述| |
- | |max_users|Integer类型, 直播间最大人数| | + | |need_password|Boolean类型,是否需要设置密码| |
+ | |password|String类型,密码| | ||
+ | |cover_picture_url|String类型,房间封面的图片URL| | ||
+ | |start_time|Long类型,(预计)开始时间| | ||
+ | |end_time|Long类型,(预计)结束时间| | ||
=== Response Body === | === Response Body === | ||
行 292: | 行 296: | ||
<code php> | <code php> | ||
- | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/stream_url?type=mobile_pull" | + | curl -X PUT -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" -d '{"chatroom":{"max_users":400},"liveroom":{"title":"sing a song", "need_password":true, "password":"123456"}, "liveshow":{"start_time":1567685678000}}' "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/2" |
</code> | </code> | ||
=== 可能返回的结果示例 === | === 可能返回的结果示例 === | ||
- | **返回值200,表示获取成功** | + | **返回值200,表示修改成功** |
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "put", | ||
+ | "application": "e1a09de0-0e03-11e7-ad8e-a1d913615409", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/2", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "start_time": true, | ||
+ | "password": true, | ||
+ | "need_password": true, | ||
+ | "title": true, | ||
+ | "max_users": true | ||
+ | }, | ||
+ | "timestamp": 1494085338811, | ||
+ | "duration": 1, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 获取直播聊天室详情 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/{liveroomid}**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/2" | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示修改成功** | ||
<code json> | <code json> | ||
行 303: | 行 367: | ||
"action": "get", | "action": "get", | ||
"application": "e1a09de0-0e03-11e7-ad8e-a1d913615409", | "application": "e1a09de0-0e03-11e7-ad8e-a1d913615409", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/2", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "id": "2", | ||
+ | "chatroom_id": "15399890518017", | ||
+ | "title": "sing a song", | ||
+ | "desc": "this is a test live room", | ||
+ | "max_users": 400, | ||
+ | "current_users": 1, | ||
+ | "status": "ongoing", | ||
+ | "anchor": "z1", | ||
+ | "passwordEnable": true, | ||
+ | "startTime": 1567685678000, | ||
+ | "endTime": 1494084880154, | ||
+ | "cover_picture_url": "", | ||
+ | "pc_pull_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1", | ||
+ | "pc_push_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1", | ||
+ | "mobile_pull_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1", | ||
+ | "mobile_push_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1" | ||
+ | }, | ||
+ | "timestamp": 1494086098297, | ||
+ | "duration": 2, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui", | ||
+ | "count": 0 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 获取直播聊天室详情 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/{liveroomid}**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/2" | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示修改成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "get", | ||
+ | "application": "e1a09de0-0e03-11e7-ad8e-a1d913615409", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/2", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "id": "2", | ||
+ | "chatroom_id": "15399890518017", | ||
+ | "title": "sing a song", | ||
+ | "desc": "this is a test live room", | ||
+ | "max_users": 400, | ||
+ | "current_users": 1, | ||
+ | "status": "ongoing", | ||
+ | "anchor": "z1", | ||
+ | "passwordEnable": true, | ||
+ | "startTime": 1567685678000, | ||
+ | "endTime": 1494084880154, | ||
+ | "cover_picture_url": "", | ||
+ | "pc_pull_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1", | ||
+ | "pc_push_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1", | ||
+ | "mobile_pull_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1", | ||
+ | "mobile_push_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_2_1" | ||
+ | }, | ||
+ | "timestamp": 1494086098297, | ||
+ | "duration": 2, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui", | ||
+ | "count": 0 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 删除直播聊天室 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:delete.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/{liveroomid}**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X DELETE -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1968" | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示删除成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "delete", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1968", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "liveRoomID": "1968", | ||
+ | "result": true | ||
+ | }, | ||
+ | "timestamp": 1496232654706, | ||
+ | "duration": 1, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 分页获取直播聊天室列表 ==== | ||
+ | 获取全部的直播聊天室列表,不区分直播聊天室状态。 | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |pagenum|页数| | ||
+ | |pagesize|每页显示数量| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms?pagenum=2&pagesize=2" | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示获取成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "get", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
"params": { | "params": { | ||
- | "type": [ | + | "pagesize": [ |
- | "mobile_pull" | + | "2" |
+ | ], | ||
+ | "pagenum": [ | ||
+ | "2" | ||
] | ] | ||
}, | }, | ||
- | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/stream_url", | + | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms", |
+ | "entities": [ ], | ||
+ | "data": [ | ||
+ | { | ||
+ | "id": "1962", | ||
+ | "chatroom_id": "17638557286401", | ||
+ | "title": "123456", | ||
+ | "desc": "fbhjj", | ||
+ | "startTime": 1496219839053, | ||
+ | "endTime": 1496219930994, | ||
+ | "anchor": "quest1919", | ||
+ | "gift_count": 0, | ||
+ | "praise_count": 0, | ||
+ | "current_user_count": 1, | ||
+ | "max_user_count": 2, | ||
+ | "status": "completed", | ||
+ | "cover_picture_url": "", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1962_1", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1962_1", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1962_1", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1962_1" | ||
+ | }, | ||
+ | { | ||
+ | "id": "1961", | ||
+ | "chatroom_id": "17637486690306", | ||
+ | "title": "vv", | ||
+ | "desc": "ddd", | ||
+ | "startTime": 1496220731055, | ||
+ | "endTime": 1496220771419, | ||
+ | "anchor": "mnabc", | ||
+ | "gift_count": 0, | ||
+ | "praise_count": 0, | ||
+ | "current_user_count": 1, | ||
+ | "max_user_count": 2, | ||
+ | "status": "completed", | ||
+ | "cover_picture_url": "", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1961_3", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1961_3", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1961_3", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1961_3" | ||
+ | } | ||
+ | ], | ||
+ | "timestamp": 1496233296564, | ||
+ | "duration": 0, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui", | ||
+ | "count": 2 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 分页获取正在直播的直播聊天室列表 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |limit|获取的数量| | ||
+ | |cursor|游标地址| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms?ongoing=true&limit=2&cursor=ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6MjE" | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示获取成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "get", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "params": { | ||
+ | "cursor": [ | ||
+ | "ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6MjE" | ||
+ | ], | ||
+ | "ongoing": [ | ||
+ | "true" | ||
+ | ], | ||
+ | "limit": [ | ||
+ | "2" | ||
+ | ] | ||
+ | }, | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms", | ||
+ | "entities": [ ], | ||
+ | "data": [ | ||
+ | { | ||
+ | "id": "1946", | ||
+ | "chatroom_id": "17290386014210", | ||
+ | "title": "呃呃呃", | ||
+ | "desc": "你w", | ||
+ | "startTime": 1495887797479, | ||
+ | "endTime": 1495887797479, | ||
+ | "anchor": "hhhhhr", | ||
+ | "gift_count": 0, | ||
+ | "praise_count": 0, | ||
+ | "current_user_count": 2, | ||
+ | "max_user_count": 3, | ||
+ | "status": "ongoing", | ||
+ | "cover_picture_url": "", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1946_1", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1946_1", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1946_1", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1946_1" | ||
+ | }, | ||
+ | { | ||
+ | "id": "1941", | ||
+ | "chatroom_id": "17276864626689", | ||
+ | "title": "trbTest", | ||
+ | "desc": "trbTest", | ||
+ | "startTime": 1495875721150, | ||
+ | "endTime": 1495875721150, | ||
+ | "anchor": "trb", | ||
+ | "gift_count": 0, | ||
+ | "praise_count": 0, | ||
+ | "current_user_count": 0, | ||
+ | "max_user_count": 1, | ||
+ | "status": "ongoing", | ||
+ | "cover_picture_url": "http://127.0.0.1/easemob-demo/chatdemoui/chatfiles/38dcb1e0-42b9-11e7-9642-258f3a183287", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1941_4", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1941_4", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1941_4", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1941_4" | ||
+ | } | ||
+ | ], | ||
+ | "timestamp": 1496233924583, | ||
+ | "duration": 0, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui", | ||
+ | "cursor": "ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6Mjg", | ||
+ | "count": 2 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 获取直播聊天室的直播状态 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/${liveroomid}/status**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1946/status" | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示获取成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "get", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1946/status", | ||
"entities": [ ], | "entities": [ ], | ||
"data": { | "data": { | ||
- | "mobile_pull": "rtmp://publish3.cdn.ucloud.com.cn/ucloud" | + | "liveRoomID": "1946", |
+ | "status": "ongoing" | ||
}, | }, | ||
- | "timestamp": 1494084603633, | + | "timestamp": 1496234759930, |
- | "duration": 1, | + | "duration": 0, |
"organization": "easemob-demo", | "organization": "easemob-demo", | ||
"applicationName": "chatdemoui", | "applicationName": "chatdemoui", | ||
行 327: | 行 798: | ||
[[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
---- | ---- | ||
+ | |||
+ | ==== 更新直播聊天室的直播状态 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:put.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/${liveroomid}/status**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X PUT -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1970/status" -d '{"status":"ongoing"}' | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示更新成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "put", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1970/status", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "liveRoomID": "1970", | ||
+ | "status": "ongoing" | ||
+ | }, | ||
+ | "timestamp": 1496235373581, | ||
+ | "duration": 0, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui", | ||
+ | "count": 0 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 新建直播场次 ==== | ||
+ | 新创建的直播聊天室,会默认创建一个直播场次,状态是not_start;如果当前直播聊天室的状态是ongoing,则不允许创建新的直播场次,此时需要将其状态设置为completed或者closed,再创建新的直播场次。 | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:post.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/${liveroomid}/liveshows**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |title|String类型,必填| | ||
+ | |desc|String类型,必填| | ||
+ | |anchor|String类型,必填| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |liveshow_id|生成的直播场次ID| | ||
+ | |chatroom_id|对应的聊天室ID| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X POST -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1970/liveshows?status=ongoing -d '{ "anchor":"z2", "title":"sing a love song", "desc":"this is a new live show"}' | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示新建成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "post", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "params": { | ||
+ | "status": [ | ||
+ | "ongoing" | ||
+ | ] | ||
+ | }, | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1970/liveshows", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "liveshow_id": "2", | ||
+ | "chatroom_id": "17654613082113", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2" | ||
+ | }, | ||
+ | "timestamp": 1496236098889, | ||
+ | "duration": 1, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 新建直播场次 ==== | ||
+ | 新创建的直播聊天室,会默认创建一个直播场次,状态是not_start;如果当前直播聊天室的状态是ongoing,则不允许创建新的直播场次,此时需要将其状态设置为completed或者closed,再创建新的直播场次。 | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:post.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/${liveroomid}/liveshows**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |title|String类型,必填| | ||
+ | |desc|String类型,必填| | ||
+ | |anchor|String类型,必填| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |liveshow_id|生成的直播场次ID| | ||
+ | |chatroom_id|对应的聊天室ID| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X POST -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1970/liveshows?status=ongoing -d '{ "anchor":"z2", "title":"sing a love song", "desc":"this is a new live show"}' | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示新建成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "post", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "params": { | ||
+ | "status": [ | ||
+ | "ongoing" | ||
+ | ] | ||
+ | }, | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/1970/liveshows", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "liveshow_id": "2", | ||
+ | "chatroom_id": "17654613082113", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1970_2" | ||
+ | }, | ||
+ | "timestamp": 1496236098889, | ||
+ | "duration": 1, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 获取appkey下正在直播的直播聊天室列表 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:basics:get.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |limit|获取的数量| | ||
+ | |cursor|游标地址| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms?ongoing=true&limit=2&cursor=ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6MzE | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示新建成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "get", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "params": { | ||
+ | "cursor": [ | ||
+ | "ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6MzE" | ||
+ | ], | ||
+ | "ongoing": [ | ||
+ | "true" | ||
+ | ], | ||
+ | "limit": [ | ||
+ | "2" | ||
+ | ] | ||
+ | }, | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms", | ||
+ | "entities": [ ], | ||
+ | "data": [ | ||
+ | { | ||
+ | "id": "1924", | ||
+ | "chatroom_id": "17177265635330", | ||
+ | "title": "具体了", | ||
+ | "desc": "就咯", | ||
+ | "startTime": 1495779917352, | ||
+ | "endTime": 1495779917352, | ||
+ | "anchor": "wuls", | ||
+ | "gift_count": 0, | ||
+ | "praise_count": 0, | ||
+ | "current_user_count": 8, | ||
+ | "max_user_count": 9, | ||
+ | "status": "ongoing", | ||
+ | "cover_picture_url": "", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1" | ||
+ | }, | ||
+ | { | ||
+ | "id": "1922", | ||
+ | "chatroom_id": "17175003856897", | ||
+ | "title": "香山", | ||
+ | "desc": "随便", | ||
+ | "startTime": 1495777760957, | ||
+ | "endTime": 1495777760957, | ||
+ | "anchor": "sx001", | ||
+ | "gift_count": 0, | ||
+ | "praise_count": 8, | ||
+ | "current_user_count": 1, | ||
+ | "max_user_count": 3, | ||
+ | "status": "ongoing", | ||
+ | "cover_picture_url": "http://127.0.0.1:8080/easemob-demo/chatdemoui/chatfiles/43a62c20-41d6-11e7-a88e-df409c88cf66", | ||
+ | "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1", | ||
+ | "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1", | ||
+ | "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1", | ||
+ | "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1" | ||
+ | } | ||
+ | ], | ||
+ | "timestamp": 1496303336669, | ||
+ | "duration": 0, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui", | ||
+ | "cursor": "ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6NDk", | ||
+ | "count": 2 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ===== 主播管理 ===== | ||
+ | ''待补充'' | ||
+ | ^名称^请求^描述^ | ||
+ | |新建主播|/{org_name}/{app_name}/chatrooms/super_admin|给一个普通IM用户赋予主播权限,只有拥有主播权限的用户| | ||
+ | |分页获取appKey下的主播列表| /{org_name}/{app_name}/liverooms/anchors|''待补充''| | ||
+ | |移除主播角色|/{org_name}/{app_name}/liverooms/anchors/${username}|移除用户的主播角色| | ||
+ | |主播关联直播聊天室|/{org_name}/{app_name}/liverooms/anchors/${username}/join/{liveroomid}|关联后,主播变成该直播聊天室的候选主播| | ||
+ | |主播取消关联直播聊天室|/{org_name}/{app_name}/liverooms/anchors/${username}/release/{liveroomid}|''待补充''| | ||
+ | |获取主播关联的直播聊天室列表| /{org_name}/{app_name}/liverooms/anchors/${username}/joined_liveroom_list|''待补充''| | ||
+ | |获取一个直播聊天室下的关联主播列表|/{org_name}/{app_name}/liverooms/${liveroomid}/anchors|''待补充''| | ||
+ | |主播绑定直播聊天室|/{org_name}/{app_name}/liverooms/${liveroomid}/anchors/${username}|绑定直播聊天室,主播即变成这个直播聊天室的正式主播| | ||
+ | |||
+ | ==== 新建主播 ==== | ||
+ | 给一个普通IM用户赋予主播权限,只有拥有主播权限的用户,才能创建直播聊天室。 | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:ready:post.png?nolink&90|}}^**/{org_name}/{app_name}/chatrooms/super_admin**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X POST -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" http://127.0.0.1:8080/easemob-demo/chatdemoui/chatrooms/super_admin -d'{"superadmin":"z10"}' | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示新建成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "post", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/chatrooms/super_admin", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "result": "success" | ||
+ | }, | ||
+ | "timestamp": 1496236798886, | ||
+ | "duration": 0, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | |||
+ | ==== 分页获取appKey下的主播列表 ==== | ||
+ | ''待补充'' | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:ready:get.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/anchors**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |pagenum|当前页数| | ||
+ | |pagesize|每页显示数量| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X GET -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/anchors?pagenum=2&pagesize=2 | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示获取成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "get", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "params": { | ||
+ | "pagesize": [ | ||
+ | "2" | ||
+ | ], | ||
+ | "pagenum": [ | ||
+ | "2" | ||
+ | ] | ||
+ | }, | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/anchors", | ||
+ | "entities": [ ], | ||
+ | "data": [ | ||
+ | "no88", | ||
+ | "no3" | ||
+ | ], | ||
+ | "timestamp": 1496242313900, | ||
+ | "duration": 0, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui", | ||
+ | "count": 2 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | ==== 移除主播角色 ==== | ||
+ | 移除用户的主播角色,用户不会被删除,变成普通IM用户。 | ||
+ | |||
+ | === HTTP Request === | ||
+ | |||
+ | ^{{:im:server:ready:delete.png?nolink&90|}}^**/{org_name}/{app_name}/liverooms/anchors/${username}**^ | ||
+ | |||
+ | === Request Headers === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |Content-Type|application/json| | ||
+ | |Authorization|Bearer ${token}| | ||
+ | |||
+ | === Request Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |pagenum|当前页数| | ||
+ | |pagesize|每页显示数量| | ||
+ | |||
+ | === Response Body === | ||
+ | |||
+ | ^参数^说明^ | ||
+ | |''不完整''|''不完整''| | ||
+ | |||
+ | === 请求示例 === | ||
+ | |||
+ | <code php> | ||
+ | curl -X DELETE -H "Authorization: Bearer YWMti2bp0NdNEea6On9r7PFKfAAAAVq-FyjtBdvG8hGqmEStXoaECQBgCHIBaqo" http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/anchors/z10 | ||
+ | </code> | ||
+ | |||
+ | === 可能返回的结果示例 === | ||
+ | |||
+ | **返回值200,表示获取成功** | ||
+ | |||
+ | <code json> | ||
+ | { | ||
+ | "action": "delete", | ||
+ | "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", | ||
+ | "uri": "http://127.0.0.1:8080/easemob-demo/chatdemoui/liverooms/anchors/z10", | ||
+ | "entities": [ ], | ||
+ | "data": { | ||
+ | "action": "remove_anchor", | ||
+ | "username": "z10", | ||
+ | "result": true | ||
+ | }, | ||
+ | "timestamp": 1496291020316, | ||
+ | "duration": 0, | ||
+ | "organization": "easemob-demo", | ||
+ | "applicationName": "chatdemoui" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ''**其他返回值待补充**'' | ||
+ | |||
+ | 如果返回结果是<wrap em>429、503</wrap>或者其他<wrap em>5xx</wrap>,有可能代表该接口被限流了,请稍微暂停一下并重试。详见[[im:450errorcode:45restastrict|接口限流说明]] | ||
+ | |||
+ | [[http://api-docs.easemob.com/|使用 Easemob REST API 在线测试]] | ||
+ | ---- | ||
+ | |||
+ | |||
+ |