Add School Label

The API call requires SID, safeKey, timeStamp and label name. Schools can add up to 100 labels. Colors are randomly assigned to each label when the label is created. The implementation returns the label ID and instruction after execution.

URL

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

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
labelName Yes 1-20 words，No distinction between English and Chinese，More than 20 words will be automatically cut to 20 words. label name Schools can add up to 100 labels.

Response Parameters

Key Type Sample Value Meaning
data object Return message object
└ labelId string 363 Add the lable id that is returned.
error_info object Return message object
└ errno number 1 error code
└ error string "Normal execution" error list

Sample

  • HTTP Request
POST /partner/api/course.api.php?action=addSchoolLabel HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=e98b01228fca036bf2ab060f7a8a6ec3&timeStamp=1493725870&labelName=数学
  • 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 "labelName=数学" \
      "https://api.eeo.cn/partner/api/course.api.php?action=addSchoolLabel"

Response Sample（The normal return json packet example）

{
    "data": {
        "labelId": "363"
    },
    "error_info": {
        "errno": 1,
        "error": "程序正常执行"
    }
}

Error Code Description

Error Code Description
1 Successful execution.
100 Incomplete or incorrect parameters.
102 No permission(Security verification failed.).
104 Operation failure(Unknown error).
353 The label already exists. (Label ID returns.)
354 Exceeded the maximum number of labels.

results matching ""

    No results matching ""