Đánh giá học sinh sau giờ học

Mục lục

SID, safekey, timeStamp, class ID, comment data, etc.Returns the details of the revised evaluation under this section.

URL #

https://api.eeo.cn/partner/api/course.api.php?action=updateClassStudentComment

HTTP Request Methods #

  • POST

Coding format #

  • UTF-8

Request data #

keyRequiredMore RestrictionsInstructionsDescription
SIDYesNullSchool IDIt is available through the eeo.cn application
safeKeyYesFixed 32-bit all lowercase charactersSchool authentication security keysafeKey=MD5(SECRET+timeStamp)
timeStampYesNullimestamp used by safeKeyUnix Epoch timeStamp is the number of seconds passed by 00:00 (world standard time) on January 1, 1970
classIdYesNullClass IDNo
commentJsonYesComment data structureNo
  └ starNumYesStartNum is a number between 0 and 5, less than 0 reset to 0, greater than 5 reset to 5Rating (star)There is no
  └ commentYesComment is a string with a length less than 1000 words, which is not case sensitive, and more than 1000 words will be automatically truncated to 1000 wordsEvaluation contentNo
  └ customColumnNullThe customColumn can be empty. If it is not empty, the length is 1-50. Chinese and English are not distinguishedUser – defined identityThere is no
  └ studentUidYesNullStudents in the UIDRegister the user UID returned by the user interface

Response data #

keyTypeSample valuemeaning
dataarray[]Returns an array of Data information
└ data Return message 1objectReturn student evaluation information
  └ studentUidstring“1001001”User’s UID
  └ customColumnstringCustom field, pass what return what, no pass not return the fieldcustom fieldCustom field
  └ errnostring1The error code
  └ errorstring“Routine execution”Error details
└ data Return message 2objectReturn student evaluation information
  └ studentUidstring“1001002”User’s UID
  └ customColumnstringCustom field, pass what return what, no pass not return the fieldCustom field
  └ errnostring1The error code
  └ errorstring“Routine execution”Error details
error_infoobjectReturn information object
  └ errnonumber1The error code
  └ errorstring“Routine execution”Error details

Sample #

  • HTTP request
POST /partner/api/course.api.php?action=updateClassStudentComment HTTP/1.1
Host: root_url
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=d8e6b1b7b55483ba93da7bc8e1d9514f&timeStamp=1493728253&classId=27981=commentJson=[{"studentUid":"1001001","starNum":"5","comment":"评价内容","customColumn":"学生1"},{"studentUid":"1001002","starNum":"5","comment":"评价内容","customColumn":"学生2"}]
  • Shell cURL analog request instruction
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
      -d "SID=1234567" \
      -d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
      -d "timeStamp=1484719085" \
      -d "classId=27981" \
      -d 'commentJson= \
        [ \
          { \
            "studentUid": "1001002", \
            "starNum": "5", \
            "comment": "评价内容", \
            "customColumn": "用户自定义标识" \
          } \
        ]' \
      "https://api.eeo.cn/partner/api/course.api.php?action=updateClassStudentComment"

Response sample(The normal return json packet example) #

{
    "data": [
        {
            "studentUid": "1001001",
            "customColumn": "学生1",
            "errno": 1,
            "error": "程序正常执行"
        },
        {
            "studentUid": "1001002",
            "customColumn": "学生2",
            "errno": 1,
            "error": "程序正常执行"
        }
    ],
    "error_info": {
        "errno": 1,
        "error": "程序正常执行"
    }
}

Error Code Description #

Error CodeDescription
1Successful execution.
100Incomplete or incorrect parameters.
102Don’t have permissions(Security verification failed).
104Operation failed (unknown error).
167There is no such student in the lesson.
228There is no such student in the institution.
233There is no such lesson in the institution.
369The operation is not supported in this type of course/lesson.
400The requested data is not valid.