CÔNG NGHỆ THÔNG TIN >> SINH VIÊN BKAP

HANAM88 Document API dành cho sinh viên Bách Khoa Aptech thực hành lập trình FrontEnd

Đăng lúc: 02:32 PM - 22/06/2023 bởi Charles Chung - 451

Để thuận tiện cho các bạn sinh viên Bách Khoa Aptech thực hành các môn học lập trình FrontEnd như Angular, ReactJS, VueJS... Trong bài viết này tôi sẽ phát hành tài liệu mô tả các API tại địa chỉ https://api.hanam88.com

Danh sách các API

(Lưu ý: Bạn nào không phải sinh viên bách khoa Aptech có thể contact với mình để có tài khoản vào thực hành nhé)

1. Đăng nhập

Parameters

Value

Note

Url

/quiz/accounts/login

 

Method

POST

 

Request JSON

{

    "username":"B9883",

    "password":"JMBYWC"

}

 

Response success

{

    "accountId""e1ee5fe5-3369-414d-8655-a2ca950d8a2d",

    "username""B9883",

    "fullname""Phí Hữu Kiên",

    "avatar""",

    "role""student",

    "accesstoken""xxx",

    "refreshtoken""xxx",

    "expiryminisecond"#####

}

 

Type token: Bearer

Response error 401

{

    "msg""Username hoặc Password không đúng hoặc User bị cấm!"

}

 

 

 

2. Đổi mật khẩu

Parameters

Value

Note

Url

/quiz/accounts/changepassword

 

Method

POST

 

Request JSON

{

    "accountId""xxx",

    "oldPassword""123456",

    "newPassword""654321"

}

With accesstoken

Response success

{

    "msg""Mật khẩu đổi thành công!"

}

 

Response error 404, 501

{

    "msg""Tài khoản không tồn tại hoặc bị cấm."

}

Hoặc

{

    "msg""Mật khẩu cũ không đúng"

}

 

 

3. Refreshtoken (sử dụng khi hết hạn accesstoken – default 30 phút)

Parameters

Value

Note

Url

/quiz/accounts/refreshtoken

 

Method

POST

 

Request JSON

{

    "accesstoken""xxx",

    "refreshtoken""xxx"

}

 

 

Response success

{

    "accesstoken""new value",

    "refreshtoken""new value"

    "expiryminisecond"275000

}

 

Expiryminisecond : thời gian hết hạn tính bằng minisecond trả về từ server

Response error 501

{

    "msg""Refresh token không hợp lệ"

}

Hoặc cố tính sửa token sẽ dẫn đến không nhận được kết quả.

 

 

 

4. Thoát (Xóa refreshtoken trên server)

Parameters

Value

Note

Url

/quiz/accounts/logout

 

Method

GET

 

Request JSON

 

With accesstoken

Response success

{

    "msg""Đã hủy refeshtoken - bạn không thể truy 

cập khi accesstoken hết hạn!"

}

 

Response error 401

 

Các lỗi hệ thống khác

 

Và còn nhiều các API về các danh mục và sản phẩm để các bạn thực hành...

Tài liệu đầy đủ tải tại đây: Link tải tài liệu (google drive)

 

thay lời cảm ơn!

QUẢNG CÁO - TIẾP THỊ