Delete Playback Viewable Users

This is an LMS classroom activity API used to remove users who can view the client-side playback for a classroom activity.

Notes

  1. 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.
  2. About this API -- Delete Playback Viewable Users
    • When deleting viewable users, each user has a separate return code in the data field.
    • If a user being deleted is not in the viewable list, no error will be returned; the user will be returned in the success list and processed normally.
    • To set all selectable users as viewable, use the Set Playback All Viewable API.
    • To set all selectable users as non-viewable, use the Set Playback All Forbidden API.

URL

https://root_url/playback/deletePlaybackUser

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
activityId No integer Classroom Activity ID Choose one with classId; activityId is preferred if available
classId No integer Class Session ID Choose one with activityId; activityId is preferred if available
uidList Yes array[string] Student UID array

Response Parameters

Parameter Type Example Description
code integer 1 Error code
msg string "Success" Error message
data object null Response data
└ successList array[int] UIDs successfully deleted
└ failedList array[object] Failed user information
└ uid int User UID
└ code int Error code
└ msg string Error message

Examples

  • HTTP Request
POST /playback/deletePlaybackUser 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,
    "activityId": 25096097,
    "uidList": [
        504026,
        504028
    ]
}
  • 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, "activityId": 25096097, "uidList": [504026, 504028]}' \
     'https://root_url/playback/deletePlaybackUser'

Response Example (Normal JSON Response)

{
    "code": 1,
    "msg": "Success",
    "data": {
        "successList": [504026,504028],
        "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
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
121609007 Account has been set to not viewable

results matching ""

    No results matching ""