RoomKit
  • iOS : Objective-C
  • Android
  • Web
  • Flutter
  • Introduction
  • Demo app
  • Sample codes
  • Client SDKs
    • SDK downloads
    • Release notes
  • Getting started
    • Integration
    • Start a room
  • Guides
    • Customize room parameters
    • Customize the room UI
    • Listen for room callbacks
    • Screen rotation support
    • Screen sharing
    • Manage rooms with Education Cloud Service
    • Use server event callbacks
  • Server APIs
  • Error codes
  • Documentation
  • RoomKit
  • Server APIs
  • RoomKit Server APIs
  • Room operations
  • End room

End room

Last updated:2022-02-25 17:04

1 Description

Ends a room.

After a room is ended, users cannot join or rejoin the room.

2 Request method and endpoint

  • Transmission protocol: HTTPS

3 Request parameters

Parameter Type Is it mandatory? Example Description
secret_id
Int64
Yes
12580
The Secret ID assigned to your project by ZEGO.
access_token
String
Yes
"CIE7hNPK6Y55DeUJBSDrInP"
The server access token obtained via the get_access_token request.
pid
Int64
Yes
1200
The Product ID assigned to your project by ZEGO.
room_id
String
Yes
"123456"
Room ID. The numeric value it represents must be a 64-bit integer.
custom_message
String
No
"Class cancelled."
The reason why the room is ended.

4 Sample request

{
    "pid": 1255,
    "room_id": "123456",
    "custom_message": "Class cancelled.",
    "secret_id": 2587762184,
    "access_token": "kaVmfcZR5P8hpqqMmAWXCGYkxf2AgpQjo3NPfBg-mVHYfYUkukaXWN-wekbdVRDlYEp4mbvq9tonqDEw2nNsiw=="
}

5 Response parameters

Parameter Type Example Description
ret
Object
-
The returned status of the request.
ret.code
Int
0
The returned code.
ret.message
String
"succeed"
The returned message.
ret.version
String
"1.0.0"
Version number.

6 Sample response

{
    "ret": {
        "code": 0,
        "message": "succeed",
        "version": "1.0.0"
    }
}
Page Directory