
DINHDANH Creator · Bài AM01 · Loạt Method · Người không chuyên vẫn dùng được
cách gọi & kết quả trả về chuẩn
Bài mở đầu: hiểu “thư viện sẵn trên trang”, cách đọc success/message/data, và bản đồ đủ method theo SECTION API REFERENCE - không cần biết PHP.
Mục tiêu: Gọi được await appifio_client.…(); đọc đúng kết quả; biết mở bài AM02-AM08 theo nhóm.
Điều kiện: Tab Backend = Phiên bản nâng cao (Advanced) → Lưu trong tab → nhấn Lưu thay đổi.
Nguồn chuẩn: Hướng dẫn API Aura Storage · mục API REFERENCE
Lưu ý quan trọng - Prompt & skills
Creator → Prompt & skills → Mẫu prompt DINHDANH → bật đúng: DINHDANH Aura Storage (Advanced) - Complete AI Guide. Agent tự có đủ Prompt/skills - bạn không cần tự cung cấp tài liệu Storage.
Không bật cùng lúc template Easy (DINHDANH Easy Storage - Complete AI Guide) - sẽ xung đột và AI hiểu nhầm.
1. Hình dung đơn giản
Trên trang web của bạn đã có sẵn một “trợ lý” tên appifio_client. Bạn chỉ gọi tên việc (method) - trợ lý gửi lên Aura Storage và trả lời. Bạn không viết lại trợ lý.
2. Hộp kết quả chuẩn (mọi method mạng)
| Ô | Nghĩa đời thường | Kiểu |
|---|---|---|
success | Thành công hay không | true / false |
message | Câu thông báo (thành công hoặc lỗi) | chuỗi chữ |
data | Nội dung hữu ích (danh sách, id, url…) - có thể không có khi lỗi | object (tuỳ method) |
throw) thay vì chỉ success: false. Nên bọc try/catch và hiện thông báo thân thiện (vd. “Thử lại sau”).Client tự kèm mã dự án và phiên đăng nhập quản trị (nếu bạn đã login) - bạn không tự gắn tay vào mọi lời gọi.
3. Mẫu gọi an toàn (copy dùng được)

try {
const res = await appifio_client.appifio_readList('contacts.json', ['id', 'name', 'email']);
if (res.success) {
const rows = res.data?.content || []; // danh sách luôn nằm ở content
// ... hiện ra trang
} else {
alert(res.message || 'Không đọc được dữ liệu');
}
} catch (e) {
alert(e.message || 'Lỗi kết nối - thử lại sau');
}typeof appifio_client === 'undefined' để “đợi load”. Hệ thống xếp hàng lời gọi đến khi sẵn sàng. Helper không mạng (AM08) gọi không cần await.4. Ai được gọi? (Auth - giải thích ngắn)
| Trong bài AM ghi | Nghĩa |
|---|---|
| Public | Khách chưa đăng nhập quản trị cũng gọi được (mặc định) |
| Admin+ | Cần đã đăng nhập (user / admin / siêu quản trị) - trừ khi ghi chú riêng |
| Siêu quản trị | Chỉ tài khoản chủ cao nhất |
| Role user bị chặn | Biên tập viên nhẹ: một số việc xóa/nguy hiểm không làm được |
5. Bản đồ đủ method (API REFERENCE → bài AM)
| § | Method (đủ danh sách) | Bài |
|---|---|---|
| 1 | readList, readFile (+id), appendData, updateData | AM02 |
| 2 | readFile (flat), writeFile, createFile, deleteFile, restoreFile, hardDeleteFile, renameFile, copyFile, fileExists, getFileInfo, listFiles, searchFiles, findByName, readField, writeField | AM03 |
| 3 | readFsFile, writeFsFile, deleteFsFile, listFsFiles, getFsFileInfo, uploadImage, uploadFile | AM04 |
| 4 | getRoutes, addRoute, removeRoute | AM05 |
| 5 | login, logout, getSession, validateAdminSession, isLoggedIn, getAuthSetupStatus, registerAdmin, changePassword, updateProfile, listAdmins, updateAdmin, deleteAdmin | AM06 |
| 6 | executeBackendFunction | AM07 |
| 7 | generateSlug, formatDateTime, formatFileSize, getRouteSlug, getQueryParams | AM08 |
Toàn bộ SECTION TXT → bài AS / AM
| SECTION TXT | AS (khái niệm/UI) | AM (kỹ thuật) |
|---|---|---|
| TỔNG QUAN | AS01 | AM01 (bản đồ) |
| BIẾN & HÀM TOÀN CỤC | - | AM09 |
| ĐỊNH DẠNG NGÀY GIỜ | - | AM08 |
| CẤU TRÚC DỮ LIỆU | AS02 | AM02 |
| ADMIN AUTHENTICATION | AS05 | AM06 |
| URL TUYỆT ĐỐI | AS04 | AM10 |
| DỮ LIỆU RỖNG & ROUTE | AS03 · AS04 | AM10 |
| RATE LIMIT & IP BLOCK | AS03 | AM10 |
| API REFERENCE | - | AM01-AM08 |
| BACKEND FUNCTION & SECRETS | AS06 | AM07 |
| LUỒNG TRIỂN KHAI | AS17 | (+ AM12) |
| SYSTEM FILES & AURA CMS | AS07-AS12 | AM11 |
| VÍ DỤ MINH HỌA | - | AM12 |
6. Cách đọc mỗi thẻ method ở bài sau
Mỗi hàm trong AM02-AM08 có đủ các mục:
- Việc làm - một câu đời thường
- Ai được gọi - Public / Admin+ / …
- Tham số - đưa gì vào
- Cách gọi - dòng code mẫu
- Kết quả trả về - chính xác ô trong
data - Lưu ý - dễ sai / giới hạn
7. Checklist
- Bạn biết kiểm
successvà đọcdata? - Bạn biết danh sách nằm ở
data.content(AM02)?
Bài tiếp theo
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Loạt Method · AM01