Set Playback All Viewable
This is an LMS classroom activity API used to set all users as viewable for client-side playback of classroom activities.
Notes
- The following general logic applies to playback viewing permission settings:
- Only classroom activities are supported, and settings can only be configured after the class ends (via both API and backend).
- Default users = lesson instructor + lesson co-instructor + lesson students (including transfer students) + other teachers in the class + class head teacher
- Selectable users = lesson instructor + lesson co-instructor + lesson students + other teachers in the class + head teacher - transferred out students
- Based on the above rules, if a student was configured not to view historical recordings when joining the class, they will be treated as a transferred-out student for historical lessons. As a result, they cannot be added to the playback viewer list for those lessons.
- For compatibility, the API supports either activityId or classId, but it is strongly recommended to use activityId.
- About this API -- Set Playback All Viewable
- Multiple classrooms can be configured in batch, with each classroom having a separate return code in the data field.
- To add certain optional users as viewable, use the Add Playback Viewable Users API.
- To remove certain optional users from viewable, use the Delete Playback Viewable Users API.
URL
https://root_url/playback/setPlaybackAllViewable
HTTP Request Methods
Request Parameters
| key |
Required |
Type |
Description |
| X-EEO-SIGN |
Yes |
string |
Signature. Rules can be found here |
| X-EEO-UID |
Yes |
string |
Institution SID |
| X-EEO-TS |
Yes |
string |
Timestamp |
Body Parameters
| key |
Required |
Type |
Description |
Rules |
| courseId |
Yes |
integer |
Class (Course) ID |
|
| activityIds |
No |
array[integer] |
Classroom Activity ID array |
Choose one with classIds; activityIds is preferred if available |
| classIds |
No |
array[integer] |
Class Session ID array |
Choose one with activityIds; activityIds is preferred if available |
Response Parameters
| Parameter |
Type |
Example |
Description |
| code |
integer |
1 |
Error code |
| msg |
string |
"Success" |
Error message |
| data |
object |
null |
Response data |
| └ successList |
array[int] |
|
Successfully configured activity/class IDs |
| └ failedList |
array[object] |
|
Failed activity/class IDs and error information |
| └ activityId |
int |
|
Activity ID |
| └ classId |
int |
|
Class session ID |
| └ code |
int |
|
Error code |
| └ msg |
string |
|
Error message |
Examples
POST /playback/setPlaybackAllViewable HTTP/1.1
root_url
ceb7a2c0534999960c02c191d409c41e
409864
1722938382
application/json
117
{
"courseId": 414193,
"activityIds": [25096097,25096099]
}
curl -X POST \
-H 'Host: root_url' \
-H 'X-EEO-SIGN: ceb7a2c0534999960c02c191d409c41e' \
-H 'X-EEO-UID: 409864' \
-H 'X-EEO-TS: 1722938382' \
-H 'Content-Type: application/json' \
-d '{"courseId": 414193, "activityIds": [25096097,25096099]}' \
'https://root_url/playback/setPlaybackAllViewable'
Response Example (Normal JSON Response)
{
"code": 1,
"msg": "Success",
"data": {
"successList": [25096097,25096099],
"failedList": []
}
}
Error Codes
| Error Code |
Description |
| 147 |
No such course information |
| 29149 |
Activity has been deleted |
| 30002 |
Activity does not exist |
| 101002005 |
Signature exception |
| 101002006 |
Timestamp expired |
| 101002008 |
Timestamp does not exist |
| 121601020 |
Business parameter error |
| 121601021 |
Course does not belong to current institution |
| 121601022 |
Course is not a standard course |
| 121601023 |
Course has expired |
| 121603001 |
Classroom information does not exist |
| 121609004 |
Class session does not exist or does not belong to the institution |
| 121609005 |
Class session has not ended |
| 121609006 |
Class session recording is not enabled |