Set Playback All Forbidden
This is an LMS classroom activity API used to clear the client-side playback viewable user list for 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 Forbidden
- 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/setPlaybackAllForbidden
HTTP Request Methods
- POST
Encoding Format
- UTF-8
Request Parameters
Header 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 passed | |
| └ classId | int | Class session ID passed | |
| └ code | int | Error code | |
| └ msg | string | Error message |
Examples
- HTTP Request
POST /playback/setPlaybackAllForbidden HTTP/1.1
Host: root_url
X-EEO-SIGN: ceb7a2c0534999960c02c191d409c41e
X-EEO-UID: 409864
X-EEO-TS: 1722938382
Content-Type: application/json
Content-Length: 117
{
"courseId": 414193,
"activityIds": [25096097,25096099]
}
- Shell cURL Command
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/setPlaybackAllForbidden'
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 |