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.


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 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


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

  • 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=数学" \

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 ""