Register Users（Multiple）

You can register up to 10 users at a time. The API call requires SID, safeKey, timeStamp and valid phone numbers or email addresses used as the account to log into the 'ClassIn client'. The Nicknames are optional. The passwords can be plaintext or MD5 encryption (MD5 encryption is recommended). The User ID(UID) will be returned after a successful registration. The UID is the unique ID of the account and is used in subsequent API calls. Therefore, please store UIDs in your database.

Notes:

• This interface does not support passing users' avatars. Please call the Edit User Info to modify the individual user's avatar information.
• The nickname is used to display on the ClassIn client. When you pass 1 or 2 in the field of addToSchoolMember and the mobile phone number/email address has never been registered before, the nickname will also be displayed as a name in the student/teacher management page in the ClassIn management console.

• Newly registered users will not be shown in the student/teacher management session by default, and here are two ways to add users to your school in the role of school student or school teacher.

  1. Pass the parameter addToSchoolMember when calling this interface. 1: add as an institution student; 2: add as an institution teacher; other values do not add as institution members)
  2. Call add Student interface and add Teacher interface to bind the user to your institution as students or teachers.

• You are only allowed to operate teachers/students added to your school, thus the binding relationship is a required step. If you did not add users to your school based on the above guidance, you would meet request failures when scheduling classes for the users. For example, the error info returns that the user is not a teacher in your school.

Please note that:

1. If the mobile phone number or email is already registered as ClassIn account, when you call register-user interface, error code 135 will be returned, together with the UID.
2. The nickname, avatar, and password will only take effect during the first registration.

URL

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

HTTP Request Methods

• POST

Coding Format

• UTF-8

Request Data

Response data

Sample

• userJson

  userJson:[
        {"telephone":"xxxx","nickname":"xxxx","password":"xxxx"},
        {"telephone":"xxxx","nickname":"xxxx","password":"xxxx"}
    ]
  

• HTTP request

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

SID=2339736&safeKey=5458edceccc78c6698de624e94364285&timeStamp=1493026245&userJson=[{"telephone":18516900101,"password":123456,"addToSchoolMember":1},{"telephone":18516900102,"password":123456,"addToSchoolMember":1}]

• 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 'userJson=
          [ \
            {\
              "telephone": 18516900101,\
              "password": 123456,\
              "addToSchoolMember": 1\
            }, 
            {
               "telephone": 18516900102,\
               "password": 123456,\
               "addToSchoolMember": 1\
            }\
          ]'\
        "https://root_url/partner/api/course.api.php?action=registerMultiple"

Response sample（The normal return json packet example）

{
    "data": [
        {
            "data": 19820374,
            "telephone": "13800000000",
            "errno": 1,
            "error": "程序正常执行"
        }
    ],
    "error_info": {
        "errno": 1,
        "error": "程序正常执行"
    }
}

Error Code Description