Account API
API Thực hiện cấp thông tin Token để xác thực request hợp lệ cho khi thực hiện gửi, lấy dữ liệu từ hệ thống MShopKeeper.
Xem hướng dẫn tối ưu cơ chế xác thực tại đây
Các thông tin cấu hình cần thiết:
| AppID |
Domain |
Secret Key |
| AppID |
Tên kết nối |
Mã bảo mật |
Để lấy các thông tin trên xem bài viết tại đây.
About
Schemes
Endpoints
api/Account/Login
POST
Thực hiện lấy thông tin Token đăng nhập
Expected Response Types
| HttpCode |
ServiceResult.ErrorType |
Mô tả |
| 401 |
|
Chuỗi AccessToken hết hạn hoặc không hợp lệ cần phải gọi cấp phát lại |
| 200 |
0 |
Không có lỗi |
| 200 |
1 |
Tham số không hợp lệ null or empty |
| 200 |
2 |
Mã cửa hàng không tồn tại |
| 200 |
3 |
Mã Appid không tồn tại trên hệ thống |
| 200 |
4 |
Chuỗi thông tin chữ ký đăng nhập không hợp lệ, timeout |
| 200 |
7 |
Thiết lập kết nối MShopKeeper đang ở trạng thái ngắt, không thể lấy dữ liệu |
| 200 |
100 |
Lỗi nội bộ API Graph |
| 200 |
102 |
Request bị từ chối, do có request cùng loại đang xử lý. Vui lòng chờ xử lý xong hoặc chờ request đang xử lý timeout thì gọi lại. |
Parameters
| Name |
In |
Description |
Required? |
Type |
| param |
body |
Đối tượng chứa thông tin đăng nhập |
true |
LoginParam |
Content Types Produced
| Produces |
| application/json |
Content Types Consumed
| Consumes |
| application/json |
Response
Trả về đối tượng ServiceResult với ServiceResult.Data là LoginResponse
Definitions
LoginData Definition
Thông tin đăng nhập
| Property |
Type |
Format |
Mô tả |
| Domain |
string |
|
Tên miền ví dụ: demoquanao.mshopkeeper.vn |
| AppID |
string |
|
AppID cần kết nối |
| LoginTime |
string |
|
Thời gian đăng nhập dạng string (giờ UTC date) |
LoginParam Definition
Tham số thông tin đăng nhập với chuỗi chữ ký tới API
| Property |
Type |
Format |
Mô tả |
| Domain |
string |
|
Tên miền ví dụ: demoquanao.mshopkeeper.vn |
| AppID |
string |
|
AppID cần kết nối |
| LoginTime |
string |
|
Thời gian đăng nhập dạng string (giờ UTC date) |
| SignatureInfo |
string |
|
Thông tin chữ ký để validate thông tin đăng nhập |
LoginResponse Definition
| Property |
Type |
Format |
Mô tả |
| AppID |
string |
|
AppID cần kết nối |
| Domain |
string |
|
Tên miền, ví dụ: demoquanao.mshopkeeper.vn |
| AccessToken |
string |
|
Chuỗi token dùng để xác thực các request |
| CompanyCode |
string |
|
Mã cửa hàng sẽ gửi cùng các request |
| Environment |
string |
|
Môi trường để build đường dẫn api request lấy, gửi dữ liệu |
ServiceResult Definition
| Property |
Type |
Format |
Mô tả |
| Code |
int |
|
Mã lỗi HttpCode (200, 500...) |
| ErrorType |
int |
|
Loại lỗi |
| ErrorMessage |
string |
|
Thông tin lỗi |
| Success |
bool |
|
True - không có lỗi logic xảy ra |
| Environment |
string |
|
Môi trường triển khai của api |
| Data |
string |
object |
Dữ liệu trả về client |
| Total |
int |
|
Tổng số bản ghi khi lấy dữ liệu phân trang |
ErrorType Definition
| HttpCode |
ServiceResult.ErrorType |
Mô tả |
| 401 |
|
Chuỗi AccessToken hết hạn hoặc không hợp lệ cần phải gọi cấp phát lại |
| 200 |
0 |
Không có lỗi |
| 200 |
1 |
Tham số không hợp lệ null or empty |
| 200 |
2 |
Mã cửa hàng không tồn tại |
| 200 |
3 |
Mã Appid không tồn tại trên hệ thống |
| 200 |
4 |
Chuỗi thông tin chữ ký đăng nhập không hợp lệ, timeout |
| 200 |
5 |
Tham số lấy phân trang vượt quá số lượng cấu hình cho phép (max 100) |
| 200 |
6 |
Tham số ngày giờ không hợp lệ (01/01/1753 - 31/12/9999) |
| 200 |
7 |
Thiết lập kết nối MShopKeeper đang ở trạng thái ngắt, không thể lấy dữ liệu |
| HttpCode |
ServiceResult.ErrorType |
Mô tả |
| 200 |
100 |
Lỗi nội bộ API Graph |
| 200 |
102 |
Request bị từ chối, do có request cùng loại đang xử lý. Vui lòng chờ xử lý xong hoặc chờ request đang xử lý timeout thì gọi lại.
Ví dụ: Khi đang gọi api login mà api chưa trả về dữ liệu lại tiếp tục gọi request login này sẽ trả về lỗi này. |
SignatureInfo Build
SignatureInfo là thông tin chữ ký để đảm bảo gói tin tham số lấy thông tin đăng nhập là toàn vẹn và hợp lệ.
Để build chuỗi chữ ký cần có cấu hình SecretKey
Danh sách tham số cấu hình lấy tại trang quản lý MShopKeeper
| AppID |
Domain |
Secret Key |
| AppID |
Tên kết nối |
Mã bảo mật |
xem bài viết lấy thông cấu hình tại đây
Chuỗi chữ ký được build theo dạng bọc thông tin tham số đẩy lên ở dạng JSON, sau đó thực hiện mã hóa một chiều theo chuẩn mã hóa Hash HMACSHA256 với salt là thông tin cấu hình SecretKey.