Registered users(multiple)
Registered users(multiple),Register up to 10 at a time。Need SID, safekey, timeStamp, register with valid phone number,As the login 'ClassIn client' account,Nicknames are fillable, passwords can be plaintext or MD5 encryption (MD5 encryption is recommended),Upon successful registration, the UID of the student will be returned (this UID is the unique ID of the account,This parameter is used by subsequent interface,It is recommended to keep)。
Note:
- This interface does not support passing user avatars,You can call the interface if you need to Edit User Nickname To modify individual user profile information。
- The nickname is displayed on the ClassIn client,It will also be displayed as a name in the eeo.cn student administration office.
- Newly registered users will not be shown in the eeo.cn student administration, and there are currently three ways to add users to the student body.
- Pass the addToSchoolMember parameter 1 on the registered user interface
- Need to be added to the course/class next time
- The interface of call Add The Student can become students of the institution.
URL
https://api.eeo.cn/partner/api/course.api.php?action=registerMultiple
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 |
userJson | Yes | Pass at least one | Bulk registered user data | There is no |
└telephone | Yes | 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 | Register mobile phone number | For example: us mobile phone number 1 (800) 643-7676 filled 001-8006437676;The phone number of mainland China is 15800000001 |
┖nickname | No | Maximum 24 characters, more than 24 characters will be automatically truncated to 24 characters | Nickname, name | Fill in this parameter and it will be used as the name and nickname of the teacher or student;Do not fill in the nickname, the login client will pop up a box to fill in the nickname, the phone number will be the teacher or student's nickname and name。Nicknames display below the user's camera in the classroom, up to 24 characters;The name is displayed in the background of eeo.cn |
┖password | Yes(Choose 1 from md5pass 2) | Null | Text passwords | 6-20 digits, error will be reported |
┖md5pass | Yes(And password 2 choose 1) | Null | MD5 Encrypted password | 32-bit MD5 encryption |
┖addToSchoolMember | No | 0 is not added as an agency member;1 plus for institutional students;2 plus for institutional teachers;Other values are not added as agency members。Do not fill in the default 0。 | If added as an institutional student, it will be displayed in the student administration office of eeo.cn;If the teacher is added as an institution, the teacher management office in eeo.cn will be displayed | Whether to be a member of the organization (teachers, students) |
└customColumn | No | 1-50 characters, more than will automatically intercept to 50 words | User - defined identity | If it is not empty, it is returned as is; if it is empty, the field is not returned |
Response data
key | Type | Sample value | meaning |
---|---|---|---|
data | array | List of registered user objects | |
└ | object | Student information is returned after registration | |
└ data | number | 1283830 | Register the successful user UID |
└ telephone | string | 13800000000 | Registered mobile phone number |
└ customColumn | string | 08cbe7986a2da0975ef0e538790b9987 | Returns the custom field passed in by the user |
└ errno | number | 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=registerMultiple HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=3276433ab0216d9aec2621431cc12248&timeStamp=1494407873&telephone=18516900101&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 "telephone=12345678900" \
-d "password=123456" \
-d "addToSchoolMember=1" \
--url "https://api.eeo.cn/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 instruction
Error code | Instruction |
---|---|
1 | Expression successful execution. |
100 | Expression parameter not all or error. |
102 | Expression dont have permissions(Security verification failed). |
114 | Expression server exception. |
131 | Expression registration failed. |
134 | Expression cell phone number is illegal. |
135 | Expression the phone number has been registered. |
137 | Expression the password is not 6 bits long. |
155 | Indicates that the length of the data array cannot be null |
224 | Indicates wrong type of uploaded image |
288 | Indicates that this number segment is invalid |
450 | Means quantity exceeded limit(Up to 10 registrations at a time) |
820 | Indicates successful registration, plus institutional student failure |
821 | Indicates successful registration, plus failure of the institution teacher |