Request
Basic information
| Field | Value |
|---|---|
| HTTP URL | https://api.dingtalk.io/v1.0/conference/videoConferences/{conferenceId}/cloudRecords/getVideos |
| HTTP Method | GET |
| Supported app types | appType-Internal app appType-Third-party enterprise app |
| Required permissions | permission-VideoConference.Conference.Read-Video Meeting information read permission |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
| x-acs-dingtalk-access-token | String | Yes | The access credential for calling this API. Obtain it as follows: - For an internal app, call the Get the access token of an internal app API. - For a third-party enterprise app, call the Get the access token of the authorized enterprise API. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| conferenceId | String | Yes | The meeting ID. Call the Create a video conference API to obtain the value of the conferenceId parameter. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| unionId | String | Yes | The unionId of the user. Call the Query user details API to obtain the value of the unionid parameter. |
Request example
HTTPResponse
Response body
| Name | Type | Description |
|---|---|---|
| videoList | Array | The list of meeting recording videos. |
| recordId | String | The recording ID. For the same video conference, if multiple recordings are made, the resulting recording videos share the same recordId. |
| unionId | String | The unionId of the recorder. |
| startTime | Long | The recording start timestamp, in milliseconds. |
| recordType | Long | The record type. Valid values: - 0: standard recording - 1: composed file |
| duration | Long | The recording duration multiplied by 1000. For example, a value of 20000 indicates that the meeting recording lasts 20 seconds. |
| fileSize | Long | The file size, in bytes. |
| endTime | Long | The recording end timestamp, in milliseconds. |
| mediaId | String | The unique media file ID. |
| regionId | String | The region ID where the media file is located. |
Response body example
Error codes
If an error is returned when calling this API, look up the solution in the Global error codes document based on the error message.| HttpCode | Error code | Error message | Description |
|---|---|---|---|
| 400 | orgAccessForbidden | orgAccessForbidden | Organization access is restricted |
| 400 | unknownUserError | unknownUserError | Unrecognized user |
| 400 | paramsError | error:%s | Parameter error |
| 400 | resourceClose | The meeting has ended | The meeting has been closed |
| 400 | cloudRecordNotFound | cloudRecordNotFound | Cloud recording record not found / cloud recording not enabled |
| 404 | waterLimitError | waterLimitError:%s | Participant count rate limit |
| 404 | permissionError | permissionError:%s | Group permission restriction |
| 500 | systemError | systemError:%s | System error |