Chuyển đến nội dung chính

Giới thiệu

Lấy thông tin về tài khoản quản trị viên, vai trò và quyền hạn của họ.

Để biết thêm thông tin về giao diện người dùng của mô-đun, hãy truy cập https://doc.oneentry.cloud/docs/category/administrators

🎯 Mô-đun này làm gì?​

Mô-đun Admins là chỉ đọc: nó lấy các tài khoản quản trị viên của dự án OneEntry của bạn và các giá trị thuộc tính của họ, với tùy chọn lọc. Việc tạo tài khoản, phân công vai trò và thu hồi quyền truy cập đều được thực hiện trong bảng điều khiển quản trị OneEntry — mô-đun SDK này chỉ đọc thông tin đó để ứng dụng của bạn có thể thấy ai có quyền truy cập và họ có thể làm gì.

🚀 Bắt đầu nhanh​

Khởi tạo mô-đun từ defineOneEntry:


const { Admins } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

Lấy thông tin quản trị viên, có thể lọc theo các điều kiện thuộc tính:

// Filter body: admins whose "num" attribute is greater than 1.
const body = [
  { attributeMarker: "num", conditionMarker: "mth", conditionValue: 1 },
];

// getAdminsInfo(body, langCode, offset, limit) — all optional except defaults.
const admins = await Admins.getAdminsInfo(body, "en_US", 0, 30);

admins.forEach((admin) => {
  console.log(admin.id, admin.identifier);
});

Truyền một mảng rỗng ([]) cho phần thân khi bạn không cần lọc.

✨ Khái niệm chính​

Quản trị viên là gì?​

Một quản trị viên (admin) là một tài khoản có quyền truy cập cao hơn để quản lý dự án OneEntry của bạn. Mỗi quản trị viên có:

  • Mã định danh - mã định danh duy nhất của quản trị viên
  • Tập thuộc tính - tập thuộc tính mà quản trị viên thuộc về (attributeSetIdentifier)
  • Giá trị thuộc tính - các trường đã được cấu hình (attributeValues)
  • Vai trò / quyền hạn - được cấu hình trong bảng điều khiển quản trị; SDK đọc chúng qua các giá trị thuộc tính

Quản trị viên và Người dùng thông thường​

LoạiMục đíchVí dụ
Quản trị viênQuản lý hệ thống (backend)Bạn, các thành viên trong nhóm của bạn
Người dùng thông thườngSử dụng ứng dụng/website của bạn (frontend)Khách hàng của bạn, người truy cập website

Quản trị viên quản lý nội dung; Users tiêu thụ nội dung.

📋 Những điều bạn cần biết​

Thuộc tính của quản trị viên​

Mỗi đối tượng quản trị viên có các trường chính sau:

{
  id: 123,                          // Unique admin ID
  attributeSetId: 27,               // Attribute set ID
  identifier: "admin",              // Unique identifier
  attributeSetIdentifier: "admins", // Attribute set identifier
  position: 1,                      // Position
  isSync: true,                     // Whether synced with the backend
  attributeValues: {}               // Attribute values
}

Lọc quản trị viên​

Lọc qua thân yêu cầu — một mảng các điều kiện, mỗi điều kiện kết hợp một attributeMarker, một conditionMarker, và một conditionValue (các dấu hiệu giống như trong mô-đun Products):

Dấu hiệuÝ nghĩaVí dụ
eqBằngstatusId = 1 (chỉ hoạt động)
neqKhông bằngrole ≠ "Viewer"
inChứa (một trong số)role in ["Editor", "Manager"]
ninKhông chứaemail not in ["@temp.com"]
mthLớn hơn (cao hơn)createdYear > 2020
lthNhỏ hơnloginCount < 5
exsTồn tại (có giá trị)Có lastLogin
nexsKhông tồn tạiChưa bao giờ đăng nhập

📊 Bảng tham khảo nhanh​

Phương thứcMô tả
getAdminsInfo()Lấy thông tin tài khoản quản trị viên, với tùy chọn lọc

Tham số​


const body = [
  {
    "attributeMarker": "num",
    "conditionMarker": "mth",
    "conditionValue": 1
  }
];

const response = await Admins.getAdminsInfo(body, "en_US", 0, 30);

Schema: (body)

attributeMarker: string
Thuộc tính mã định danh văn bản
ví dụ: price

conditionMarker: string
Điều kiện mã định danh văn bản, các giá trị có thể: 'in' - chứa, 'nin' - không chứa, 'eq' - bằng, 'neq' - không bằng, 'mth' - lớn hơn, 'lth' - nhỏ hơn, 'exs' - tồn tại, 'nexs' - không tồn tại
ví dụ: in
Enum: [ in, nin, eq, neq, mth, lth, exs, nexs ]

conditionValue: number
Giá trị điều kiện
ví dụ: 1

❓ Câu hỏi thường gặp (FAQ)​

Sự khác biệt giữa mô-đun Admins và Users là gì?​

  • Admins - tài khoản của nhóm backend quản lý hệ thống (chỉ đọc ở đây).
  • Users - tài khoản frontend sử dụng ứng dụng/website của bạn (Users module).

Tôi có thể tạo hoặc chỉnh sửa quản trị viên với mô-đun này không?​

Không. Mô-đun Admins là chỉ đọc. Tạo tài khoản, phân công vai trò và quyền hạn, và thu hồi quyền truy cập trong bảng điều khiển quản trị OneEntry.

🎓 Thực hành tốt nhất​

  • Không bao giờ tiết lộ thông tin xác thực quản trị viên hoặc mã thông báo đặc quyền trong mã frontend.
  • Sử dụng bộ lọc để chỉ lấy những quản trị viên bạn cần thay vì toàn bộ danh sách.
  • Thực hiện nguyên tắc tối thiểu quyền hạn khi cấu hình vai trò trong bảng điều khiển quản trị.

🔗 Tài liệu liên quan​