Xác Thực

Phần này cung cấp các thông tin về cách lấy Access-Token và hướng dẫn điền Access-Token khi sử dụng các API.

Thông Tin Quan Trọng

Các Request có yêu cầu xác thực người dùng thì phải gửi kèm các thông tin như sau trong Headers.

Key	Value
Accept	application/json
Token	Access-Token

Trong đó Access-Token là Mã Xác Thực của người dùng.

BẠN CÓ BIẾT

Hiện tại, có 2 cách để lấy Access-Token, dùng Static API Token hoặc Password API Token.

Static API Token

Xem Access-Token tại phần Tích hợp API của SuperAI.

LƯU Ý

• Mục này dành cho các đơn vị muốn kết nối thông qua Token Được Cung Cấp Sẵn, các khách hàng cá nhân hoặc các đơn vị chỉ có 1 Shop cần kết nối.
• Phần lớn Khách Hàng/Đối Tác sử dụng Phương Thức Xác Thực này.

Password API Token

API này cho phép bạn lấy Access-Token (Mã Xác Thực) của người dùng thông qua Số Điện Thoại/Email và Mật Khẩu.

LƯU Ý

Mục này chỉ dành cho đối tác Sàn Thương Mại Điện Tử, Các Đơn Vị Phần Mềm có nhiều khách hàng bên trong cần kết nối SuperAI.

Endpoint

post/v1/platform/auth/token

Request

Các Tham Số

Thuộc_Tính	Bắt_Buộc	Kiểu_DL	Mô_Tả_Chi_Tiết
username	Có	String	Số Điện Thoại/Email của Tài Khoản. Ví dụ: 0987654321.
password	Có	String	Mật Khẩu của Tài Khoản.
partner	Có	String	Mã Bí Mật. Dành cho các Đối Tác Thương Mại Điện Tử lớn với SuperAI.

Ví Dụ

curl --location --request POST 'https://dev.superai.vn/v1/platform/auth/token' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "username": "0987654321",
    "password": "Sps@_3234235",
    "partner": "lPxLuxfiTotCyZ1ZnQjMepUL24HLd05ybNBhVGFN"
}'

Response

Kết Quả Trả Về

Thuộc_Tính	Kiểu_DL	Mô_Tả_Chi_Tiết
token	String	Access Token. Ví dụ: ZT2PS0pmHPHDKjRu6EMIcoM8rFM8XYHZ1Ye3zRiQ.

Ví dụ

{
    "error": false,
    "message": "",
    "data": {
        "token": "ZT2PS0pmHPHDKjRu6EMIcoM8rFM8XYHZ1Ye3zRiQ"
    }
}