Teacher's evaluation of students in the new class

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

key Required More Restrictions Instructions Description
SID Yes Null School ID It is available through the eeo.cn application
safeKey Yes Fixed 32-bit all lowercase characters School authentication security key safeKey=MD5(SECRET+timeStamp)
timeStamp Yes Null imestamp used by safeKey Unix Epoch timeStamp is the number of seconds passed by 00:00 (world standard time) on January 1, 1970
classId Yes Null Class ID No
commentJson Yes Comment data structure No
　 └ studentAccount Null To be deprecated at 1st May!Please use studentUid. Format: 00 country number - mobile phone number; note: China's mobile phone number does not include the country number, and the first mobile phone number cannot be 0.Either studentUid or studentUid. If studentAccount is passed to studentUid at the same time, the studentUid parameter shall prevail Student phone number For example: us mobile phone number 1 (800) 643-7676 filled 001-8006437676;The phone number of mainland China is 15800000001
　 └ starNum Yes StartNum is a number between 0 and 5, less than 0 reset to 0, greater than 5 reset to 5 Rating (star) There is no
　 └ comment Yes Comment 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 words Evaluation content No
　 └ customColumn Null The customColumn can be empty. If it is not empty, the length is 1-50. Chinese and English are not distinguished User - defined identity There is no
　 └ studentUid Null Either studentAccount or studentAccount. If studentUid is passed to studentAccount at the same time, the studentUid parameter shall prevail Students in the UID Register the user UID returned by the user interface

Response data

key Type Sample value meaning
data array [] Returns an array of Data information
└ data Return message 1 object Return student evaluation information
　 └ studentUid string "1001001" User's UID
　 └ customColumn string Custom field, pass what return what, no pass not return the field custom field Custom field
　 └ errno string 1 The error code
　 └ error string "Routine execution" Error details
└ data Return message 2 object Return student evaluation information
　 └ studentUid string "1001002" User's UID
　 └ customColumn string Custom field, pass what return what, no pass not return the field Custom field
　 └ errno string 1 The error code
　 └ error string "Routine execution" Error details
error_info object Return information object
　 └ errno number 1 The error code
　 └ error string "Routine execution" Error details

Sample

  • HTTP request
POST /partner/api/course.api.php?action=updateClassStudentComment HTTP/1.1
Host: www.eeo.cn
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 instruction

Error code Instruction
1 Expression successful execution.
100 Expression parameter not all or error.
102 Expression dont have permissions（Security verification failed）.
104 Expression operation failed (unknown error).
167 Indicates that this student does not exist at the end of the class
228 Indicates that there is no such student under the institution
233 Indicates that there is no such class
369 The class/session type does not support this operation
400 Indicates that the request data is not valid

results matching ""

    No results matching ""