Skip to content

Web Server API

REST APIs for meeting management, URL join, live streaming, and recording.

Create Meeting

URL: https://xx.com/WebAPI/meetingcreate

Method: POST (Content-Type: multipart/form-data)

Parameters:

NameRequiredTypeDescription
keyYesstringEnterprise ID
meetingnameYesstringMeeting name
starttimeYesstringStart time (Unix timestamp, seconds)
endtimeNostringEnd time (omit for permanent)
chairmanpwdYesstringChair password, 4–20 chars
isliveNostring1 live, 0 not live

Response:

json
{
    "version": 1173,
    "serial": 754884357,
    "roomid": "5ff66be5bfc2421a04767eb7",
    "sig": "203usx24yeijd3zjfbpTqWGskyA2Hw7z9ngrZDQFV8=",
    "pushurl": "domain/app/754884357?auth_key=...",
    "pullurl": "domain/live/754884357.m3u8?auth_key=...",
    "pullurl2": "domain/hls/754884357.m3u8",
    "recordpath": "domain/upload/754884357.mp4",
    "result": 0
}
FieldTypeDescription
serialintMeeting ID
roomidstringMedia server room id
sigstringUsed when sharing meetings
pushurlstringPush stream URL
pullurlstringPull stream URL
recordpathstringRecording file path
resultstring0 success, others error

Modify Meeting

URL: https://xx.com/WebAPI/meetingmodify · Method: POST

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialYesstringMeeting ID
meetingnameNostringMeeting name
chairmanpwdNostringChair password
starttimeYesstringStart time (timestamp)
endtimeNostringEnd time

Delete Meeting

URL: https://xx.com/WebAPI/meetingdelete · Method: POST

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialYesstringMeeting ID

Get Class Duration

URL: https://xx.com/WebAPI/getClassBeginTime · Method: GET

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialYesstringMeeting ID

Returns duration (seconds) on success.

Bind Meeting Documents

URL: https://xx.com/WebAPI/meetingbindfile · Method: POST

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialYesstringMeeting ID
fileidarr[]YesarrayFile IDs

Upload Meeting Background

URL: https://xx.com/WebAPI/uploadRoomPic · Method: POST

NameRequiredTypeDescription
keyYesstringEnterprise ID
filedataYesfileImage file
serialYesstringMeeting ID

Get Meeting Document List

URL: https://xx.com/WebAPI/getmeetingfile · Method: GET

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialYesstringMeeting ID

Get Live Stream

URL: https://xx.com/WebAPI/getLiveStream · Method: GET

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialNostringMeeting ID

Meeting Member Login Records

URL: https://xx.com/WebAPI/getlogininfo · Method: POST

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialYesstringMeeting ID

URL Join (Multi-Parameter)

URL:

https://xx.com/h5/#/login?serial=123456789&userid=1234&username=name&invisible=1&joinRole=presenter

Method: GET

NameRequiredTypeDescription
serialYesstringMeeting ID
useridYesstringUnique user ID
usernameYesstringDisplay name
invisibleYesstring0 visible, 1 invisible
joinRoleYesstringpresenter, speaker, or chairman

URL Join (Single Parameter)

URL:

https://xx.com/h5/index.html?token=encrypted-token-string

Method: GET

Token generation (Java):

java
String param = "{\"serial\":\"111111\",\"userid\":\"123456\",\"username\":\"weiyi我\",\"joinRole\":\"presenter\"}";
// AES-256 encrypt with provided key/iv, URL-encode Base64 result
// See full Java/PHP examples in Chinese doc or contact support for keys

Token generation (PHP):

php
$arr = array('serial' => '111111', 'userid' => '123456', 'username' => 'weiyi我', "joinRole"=>"presenter");
// AES-256-CBC with provided passkey/passphrase

Full Java and PHP source code is identical to the Chinese version.

Get Recording Files

URL: https://xx.com/WebAPI/getRoomRecord · Method: POST

NameRequiredTypeDescription
keyYesstringEnterprise ID
serialNostringMeeting ID
useridNostringAssociated user

filepath must be combined with recording server domain and port.

Error Codes

CodeDescription
3001Server expired
3002Company frozen
3003Meeting deleted or expired
4001Company not found
4007Meeting not found, invalid, or expired
4101Enterprise ID required
4102Invalid enterprise ID
4110Meeting requires password
5205Display name required
5208User already logged in
9999System busy, retry
20001Use POST request

See Chinese error code reference for the complete list.

微议Pro SDK 开发者文档