
DINHDANH Creator · Bài AM06 · API REFERENCE §5 · 12 method
đủ 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ự.
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

appifio_login(username, password) · Publicconst 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ậpawait 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 clientViệ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 awaitconst 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() · Publicconst 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();AM07 - executeBackendFunction (§6)
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Loạt Method · AM06