Tạo tag trường học

Mục lục

English below

API yêu cầu các tham số SID, safeKey, timeStamp và tên tag. Mỗi trường có thể thêm tối đa 100 thẻ. Màu sắc được chỉ định ngẫu nhiên cho mỗi thẻ khi được tạo. Việc triển khai trả về ID thẻ và nội dung tương ứng.

URL

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

HTTP Request Methods

  • POST

Coding Format

  • UTF-8

Request Data

Key Bắt buộc Yêu cầu thêm Mô tả Hướng dẫn
SID Bắt buộc — ID của trường Xem dữ liệu này tại Trang quản lý classin.com trong mục API
safeKey Bắt buộc Fixed 32-bit all lowercase characters Khóa bảo mật xác thực trường học safeKey=MD5(SECRET+timeStamp)
timeStamp Bắt buộc — Theo Unix Epoch timestamp & có hiệu lực trong vòng 20 phút Thời gian UNIX Epoch là số giây đã trôi qua kể từ 00:00:00 (giờ chuẩn quốc tế) vào ngày 1 tháng 1 năm 1970
labelName Bắt buộc 1-20 tự，hệ thống sẽ tự động cắt khi nhiều hơn 20 ký tự tên tag Tối đa 100 tag

Response Data

Key Định dạng Phản hồi Ý nghĩa
data object   Return message object
└ labelId string 363 Add the lable id that is returned.
error_info object   Return message object
└ errno number 1 Mã lỗi
└ error string “Normal execution” Chi tiết lỗi

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 Mô tả
1 Thành công
100 Parameters sai định dạng hoặc không hoàn chỉnh
102 Không có quyền thao tác (Xác thực bảo mật thất bại)
104 Thao tác thất bại
353 Tag đã tồn tại (trả về kèm với dữ liệu labelID)
354 Vượt quá số lượng tag tối đa