Thay đổi mật khẩu người dùng cần các tham số SID, safekey, timeStamp, số điện thoại di động, mật khẩu gốc (dạng mã hóa MD5), mật khẩu mới (bạn có thể chọn một trong hai kiểu mật khẩu – dạng văn bản hoặc mã hóa MD5) và thực hiện theo hướng dẫn sau.
Change user password needs SID, safekey, timeStamp, the mobile phone number, the original password (MD5 encryption), the new password (you can choose either the plaintext or MD5 encryption), and follows the instructions below for execution.
URL #
https://api.eeo.cn/partner/api/course.api.php?action=modifyPassword
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 |
| oldMd5pass | Bắt buộc | — | Mật khẩu cũ dạng mã hóa MD5 | Mã hóa 32-bit MD5 |
| password | Bắt buộc (Hoặc có thể bỏ qua và dùng md5pass) | — | Mật khẩu mới dạng văn bản không mã hóa | Mật khẩu có độ dài trong khoảng từ 6 – 20 ký tự. Nếu mật khẩu không đúng như yêu cầu thì báo lỗi sẽ hiển thị. |
| md5pass | Bắt buộc (Hoặc có thể bỏ qua và dùng password) | — | Mật khẩu mới dạng mã hóa MD5 | Mã hóa 32-bit MD5 |
| uid | Bắt buộc | — | UID của người dùng | UID người dùng được trả về từ lệnh Tạo tài khoản (Register Users) |
Response data #
| Key | Định dạng | Phản hồi | Ý nghĩa |
|---|---|---|---|
| error_info | object | Return message object | |
| └ errno | number | 1 | Mã lỗi |
| └ error | string | “Normal execution” | Thông tin lỗi |
Sample #
- HTTP request
POST /partner/api/course.api.php?action=modifyPassword HTTP/1.1
Host: root_url
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=8d3fb00ceddd29638e2d5dd12d69841d&timeStamp=1492793638&telephone=23692341020&oldMd5pass=e10adc3949ba59abbe56e057f20f883e&md5pass=e10adc3949ba59a
- 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=12345678901" \
-d "oldMd5pass=e10adc3949ba59abbe56e057f20f883e" \
-d "md5pass=e10adc3949ba59abbe56e057f20f88232" \
"https://api.eeo.cn/partner/api/course.api.php?action=modifyPassword"
Response sample（The normal return json packet example） #
{
"error_info":{
"errno":"1",
"error":"程序正常执行"
}
}
Error Code Instruction #
| 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 |
| 113 | Số điện thoại chưa được đăng ký |
| 114 | Lỗi server |
| 134 | Số điện thoại không hợp lệ |
| 137 | Độ dài mật khẩu không hợp lệ (6-20 ký tự) |
| 138 | Mật khẩu cũ không chính xác |
| 400 | Dữ liệu yêu cầu không hợp lệ |
