Polyv Help Center

Help Center

Query Seminar Meeting Type

Updated: 2022-10-09 09:57:48

API Description

1、查询研讨会会议类型
2、接口支持https协议

API URL

https://api.polyv.net/meet/v1/channel/live-type/get

Request Method

GET

API Constraints

  1. The API call has a frequency limit. Click here for details

Request Parameter Description

Parameter Required Type Description
appId true String Account appId [See Get Secret Key]
timestamp true Long Current 13-digit millisecond timestamp, valid within 3 minutes
sign true String Signature, a 32-character uppercase MD5 value [See Signature Generation Rules]
channelId true String Channel ID

Example

https://api.polyv.net/meet/v1/channel/live-type/get?appId=frlr1zazn3&sign=8661982EB3646269F9824A6ACCACE25C&timestamp=1621843737789&channelId=2191532

Response Parameter Description

Parameter Type Description
code Integer Status code, same as HTTP status code, used to determine the basic response status
status String Response result, determined by the business. Returns success on success, error on failure
success Boolean Whether the response is successful
requestId String Request ID, a unique UUID generated for each request, only for troubleshooting and debugging, should not be tied to business logic
error Object Error information when status code is not 200 [See Error Field Description]
data Object Failure reason, returned on failure. Empty on success [See data Field Description]

Error Parameter Description

Parameter Type Description
code Integer Error code, used to determine the specific error reason
desc String Error description, corresponding to error.code

data Field Description

Parameter Type Description
seminarLiveType String Meeting type
private - Internal seminar (default)
public - External live broadcast

Java Request Example

For quick access to the basic code, please download the relevant dependency source code. Click here to download the source code. After downloading, add it to your own source project. The HttpUtil.java and LiveSignUtil.java in the test cases are included in the downloaded file.

It is strongly recommended that you use the Live Java SDK to complete the API functionality integration. The Live Java SDK provides unified encapsulation and optimization for API call logic, exception handling, data signing, and HTTP request thread pools.

private static final Logger log = LoggerFactory.getLogger(LiveTypeGet.class);
/**
 * 查询研讨会会议类型
 * @throws IOException
 */
@Test
public void testGetLiveType() throws IOException, NoSuchAlgorithmException {
    //公共参数,填写自己的实际参数
    String appId=super.appId;
    String appSecret=super.appSecret;
    String userId = super.userId;
    String timestamp=String.valueOf(System.currentTimeMillis());
    //业务参数
    String url = "https://api.polyv.net/meet/v1/channel/live-type/get";

    //http 调用逻辑
    Map<String,String> requestMap = new HashMap<>();
    requestMap.put("appId", appId);
    requestMap.put("timestamp",timestamp);
    requestMap.put("channelId",channelId);
    requestMap.put("sign",LiveSignUtil.getSign(requestMap, appSecret));
    String response = HttpUtil.get(url, requestMap);
    log.info("测试查询研讨会会议类型接口返回值:{}",response);
    //do somethings
}

Response Example

For global system error descriptions, see Global Error Description

Success Example

{
  "code": 200,
  "status": "success",
  "requestId": "82c0b2fba8a940419c75540f3fb6a635.64.16652792402064377",
  "data": {
    "seminarLiveType": "private"
  },
  "success": true
}

Error Example

{
    "code": 400,
    "status": "error",
    "message": "invalid signature.",
    "data": ""
}
联系客服,在线咨询
在线咨询