Tab Backend DINHDANH Creator với API key gắn ứng dụng cho appifio_client
Backend Creator - API key

DINHDANH Creator · Bài AM01 · Loạt Method · Người không chuyên vẫn dùng được

appifio_client:
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ý.

Trang của bạn → await appifio_client.appifio_tênHàm(...)
→ Aura Storage xử lý
→ Trả về hộp kết quả: { success, message, data? }

2. Hộp kết quả chuẩn (mọi method mạng)

ÔNghĩa đời thườngKiểu
successThành công hay khôngtrue / false
messageCâu thông báo (thành công hoặc lỗi)chuỗi chữ
dataNội dung hữu ích (danh sách, id, url…) - có thể không có khi lỗiobject (tuỳ method)
Một số lỗi mạng / quyền (401, 403, quá lớn 413, gửi quá dày 429) có thể ném lỗi (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)

DINHDANH Creator Code: mã live dùng window.appifio để lấy site_url trong dự án
Mẫu gọi an toàn
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');
}
Không viết 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 ghiNghĩa
PublicKhá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ặnBiê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
1readList, readFile (+id), appendData, updateDataAM02
2readFile (flat), writeFile, createFile, deleteFile, restoreFile, hardDeleteFile, renameFile, copyFile, fileExists, getFileInfo, listFiles, searchFiles, findByName, readField, writeFieldAM03
3readFsFile, writeFsFile, deleteFsFile, listFsFiles, getFsFileInfo, uploadImage, uploadFileAM04
4getRoutes, addRoute, removeRouteAM05
5login, logout, getSession, validateAdminSession, isLoggedIn, getAuthSetupStatus, registerAdmin, changePassword, updateProfile, listAdmins, updateAdmin, deleteAdminAM06
6executeBackendFunctionAM07
7generateSlug, formatDateTime, formatFileSize, getRouteSlug, getQueryParamsAM08

Toàn bộ SECTION TXT → bài AS / AM

SECTION TXTAS (khái niệm/UI)AM (kỹ thuật)
TỔNG QUANAS01AM01 (bản đồ)
BIẾN & HÀM TOÀN CỤC-AM09
ĐỊNH DẠNG NGÀY GIỜ-AM08
CẤU TRÚC DỮ LIỆUAS02AM02
ADMIN AUTHENTICATIONAS05AM06
URL TUYỆT ĐỐIAS04AM10
DỮ LIỆU RỖNG & ROUTEAS03 · AS04AM10
RATE LIMIT & IP BLOCKAS03AM10
API REFERENCE-AM01-AM08
BACKEND FUNCTION & SECRETSAS06AM07
LUỒNG TRIỂN KHAIAS17(+ AM12)
SYSTEM FILES & AURA CMSAS07-AS12AM11
VÍ DỤ MINH HỌA-AM12
Loạt AM không dạy method panel CMS/MCP nội bộ. Vận hành CMS/MCP: loạt AS07-AS16 (chỉ nút trên giao diện).

6. Cách đọc mỗi thẻ method ở bài sau

Mỗi hàm trong AM02-AM08 có đủ các mục:

  1. Việc làm - một câu đời thường
  2. Ai được gọi - Public / Admin+ / …
  3. Tham số - đưa gì vào
  4. Cách gọi - dòng code mẫu
  5. Kết quả trả về - chính xác ô trong data
  6. Lưu ý - dễ sai / giới hạn

7. Checklist

  1. Bạn biết kiểm success và đọc data?
  2. Bạn biết danh sách nằm ở data.content (AM02)?

DINHDANH Creator · Loạt Method · AM01