auth

Cho phép bạn xác thực người dùng.

Mô tả

Nó trả về một Promise mà giải quyết thành một đối tượng IAuthEntity.

AuthProvider.auth(

marker*, body*, body.authData*, authData.marker*, authData.value*

);

Sơ đồ tham số

Sơ đồ

marker(bắt buộc): string
Định danh văn bản của nhà cung cấp ủy quyền
ví dụ: "email"

body(bắt buộc): IAuthPostBody
Các đối tượng chứa thông tin xác thực
ví dụ:

{
  "authData": [
    {
      "marker": "login",
      "value": "example@oneentry.cloud"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ]
}

body.authData(bắt buộc): IAuthData[]
Một mảng các đối tượng dữ liệu xác thực, mỗi đối tượng chứa một marker và giá trị tương ứng của nó.
ví dụ:

[
  {
    "marker": "login",
    "value": "user@example.com"
  }
]

authData.marker(bắt buộc): string
Định danh cho trường xác thực.
ví dụ: "login"

authData.value(bắt buộc): string
Giá trị của trường xác thực.
ví dụ: .com"

body.authData any[]
Dữ liệu ủy quyền lấy từ biểu mẫu đính kèm với nhà cung cấp ủy quyền
ví dụ: ""

[
  {
    "marker": "login",
    "value": "example@oneentry.cloud"
  },
  {
    "marker": "password",
    "value": "12345"
  }
]

body.authData[index].marker string
Định danh thuộc tính đăng ký của biểu mẫu đăng nhập
ví dụ: "example@oneentry.cloud"

body.authData[index].value string
Giá trị thuộc tính đăng ký của biểu mẫu đăng nhập
ví dụ: "12345"

Thử nghiệm trực tiếp

Chạy phương thức này một cách tương tác trong JS SDK sandbox — kết nối URL Dự án và Mã thông báo Ứng dụng của bạn khi truy cập lần đầu, sau đó mở bất kỳ kịch bản nào bên dưới để xem các luồng xác thực thực tế:

• Cập nhật người dùng — xác thực, sau đó cập nhật các trường hồ sơ của người dùng.
• Lịch sử đơn hàng — xác thực người dùng, sau đó lấy lịch sử đơn hàng cá nhân của họ.
• Thanh toán đơn hàng — xác thực trước khi đặt và thanh toán cho một đơn hàng.
• Đăng ký đơn hàng — xác thực, sau đó kiểm tra xem có đăng ký hoạt động hay không.
• Đặt vé — xác thực như một phần của quy trình thanh toán vé.
• Đơn hàng khách — đăng nhập như một khách trước khi đặt hàng.
• Đặt lại mật khẩu — đăng nhập lại ngay sau khi người dùng thay đổi mật khẩu của họ.
• Đăng ký người dùng — xác thực ngay sau khi đăng ký.

---

Ví dụ

Ví dụ tối thiểu

const body = {
  "authData": [
    {
      "marker": "login",
      "value": "example@oneentry.cloud"
    },
    {
      "marker": "password",
      "value":"12345"
    }
  ]
};
const response = await AuthProvider.auth('email', body);

Ví dụ phản hồi

{
  "userIdentifier": "test@test.ru",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpX...",
  "refreshToken": "1776262769878-0ef81b3a-6d47-49d8..."
}

Sơ đồ phản hồi

Sơ đồ: IAuthEntity

userIdentifier: string
Định danh duy nhất cho người dùng.
ví dụ: "user12345"

authProviderIdentifier: string
Định danh cho nhà cung cấp xác thực.
ví dụ: "email"

accessToken: string
Mã thông báo truy cập cho phiên người dùng.
ví dụ: "abcdef123456"

refreshToken: string
Mã thông báo làm mới để gia hạn mã thông báo truy cập.
ví dụ: "ghijkl789012"

---