Panel About Backend đề cập hạ tầng xác thực cho ứng dụng
Khả năng auth Backend

DINHDANH Creator · Bài AM06 · API REFERENCE §5 · 12 method

Đăng nhập & tài khoản quản trị
đủ method - tham số · trả về · lưu ý

Không đọc/ghi login.json bằng tay. Username: 3-50 ký tự (chữ/số/_/-/.). Mật khẩu tối thiểu 6 ký tự.

Quy tắc vàng: Trang admin luôn gọi validateAdminSession() - không chỉ dựa vào isLoggedIn(). Field “còn đăng nhập” đúng tên: authenticated.

A. Đăng nhập · phiên

Panel kho Backend dùng cho dữ liệu tài khoản admin
Kho cho dữ liệu auth
appifio_login(username, password) · Public
const r = await appifio_client.appifio_login('admin', 'pass123');

Trả về data: admin_token, admin_id, username, role, expires_at, expires_in.

Lưu ý: Client tự giữ phiên đăng nhập sau khi thành công - bạn không tự “hash mật khẩu” trên trình duyệt. Sai nhiều lần → tạm khóa (“Thử lại sau”).

appifio_logout() · Cần đang đăng nhập
await appifio_client.appifio_logout();

Trả về: { success: true } - xóa phiên trên máy chủ và trên trình duyệt.

appifio_getSession() · Public*

*Cần có phiên trong request mới authenticated: true.

const r = await appifio_client.appifio_getSession();
// r.data.authenticated - true | false
// khi true: admin_id, username, role, display_name?, avatar?, bio?, social?, expires_at?

Không dùng tên field kiểu logged_in - đúng là authenticated.

validateAdminSession() - helper client

Việc: Hỏi máy chủ còn đăng nhập không; phiên hỏng thì tự dọn phía trình duyệt. Dùng khi mở trang admin.

const s = await appifio_client.validateAdminSession();
// { authenticated, username?, role?, admin_id?, expires_at? }
if (!s.authenticated) location.href = '/login.html';

Lưu ý: Không thay bằng isLoggedIn().

isLoggedIn() - helper · không await
const maybe = appifio_client.isLoggedIn(); // boolean

Trả về: true/false - chỉ biết trình duyệt có dấu hiệu phiên, chưa xác thực máy chủ. Chỉ dùng gợi ý UI, không dùng làm cửa bảo vệ.

B. Setup lần đầu · đăng ký

appifio_getAuthSetupStatus() · Public
const r = await appifio_client.appifio_getAuthSetupStatus();
// r.data.needs_setup === true  → chưa có admin nào
appifio_registerAdmin(username, password, role?)

Ai được gọi: Lần đầu (chưa có admin) → Public, tài khoản đầu luôn siêu quản trị (bỏ qua role). Sau đó → chỉ siêu quản trị tạo thêm.

Tham số role: 'user' | 'admin' | 'superadmin'

await appifio_client.appifio_registerAdmin('editor', 'pass', 'user');

Trả về data: admin_id, username, role, is_first_admin?

C. Hồ sơ bản thân

appifio_changePassword(oldPassword, newPassword) · Admin+ (mọi role)
await appifio_client.appifio_changePassword('old', 'new');

Lưu ý: Mật khẩu mới ≥ 6 ký tự. Các phiên đăng nhập khác của cùng tài khoản bị hủy.

appifio_updateProfile(params) · Admin+

Tham số (tuỳ chọn từng cái): username, display_name, avatar, bio, social, và/hoặc old_password + new_password.

const r = await appifio_client.appifio_updateProfile({ display_name: 'Chủ shop' });
// data: username, display_name, avatar, bio, social, password_changed?

D. Siêu quản trị quản team

appifio_listAdmins() · Admin+ (role user bị chặn)
const r = await appifio_client.appifio_listAdmins();
// data.admins: [{ admin_id, username, role, display_name, avatar, bio, social,
//                 created_at, updated_at, last_active_at }]
appifio_updateAdmin(adminId, changes) · Siêu quản trị

Tham số changes: { role?, new_password? }

await appifio_client.appifio_updateAdmin('adm_xxx', { role: 'user' });
await appifio_client.appifio_updateAdmin('adm_yyy', { new_password: '...' });

Lưu ý: Đổi mật khẩu → hủy phiên của người đó. Không hạ bậc siêu quản trị cuối cùng.

appifio_deleteAdmin(adminId) · Siêu quản trị
await appifio_client.appifio_deleteAdmin('adm_xxx');

Lưu ý: Không tự xóa chính mình; không xóa siêu quản trị cuối.

Ví dụ - login / setup

const setup = await appifio_client.appifio_getAuthSetupStatus();
if (setup.data.needs_setup) {
  await appifio_client.appifio_registerAdmin(username, password);
  await appifio_client.appifio_login(username, password);
} else {
  await appifio_client.appifio_login(username, password);
}
const session = await appifio_client.validateAdminSession();
Checklist §5: login · logout · getSession · validateAdminSession · isLoggedIn · getAuthSetupStatus · registerAdmin · changePassword · updateProfile · listAdmins · updateAdmin · deleteAdmin = 12/12

AM07 - executeBackendFunction (§6)

DINHDANH Creator · Loạt Method · AM06