Tab Code hien viec dung appifio_client trong script trang
Client DINHDANH da inject

DINHDANH Creator · Bài T02 · Thuật ngữ

appifio_client
và bootstrap inject

Thư viện backend đã được hệ thống gắn sẵn vào trang - AI (và bạn) chỉ được gọi, không được viết lại class.

Mục tiêu: Hiểu vì sao luôn có appifio_client; dùng waitForAppStorage(); tránh check sai typeof === 'undefined'.

Trước: T01, F01 · Sau: T03 · Nhãn UI: tab Backend · Hỏi AI về backend · Easy / Advanced

1. Sơ đồ inject

Trang HTML load → App Storage Bootstrap chạy TRƯỚC nội dung app
→ tạo window.appifio.global.apps (mã dự án / tên link DINHDANH, api_url, api_key, backend_version)
→ định nghĩa getter window.appifio_client
→ script client chưa sẵn: trả proxyClient (xếp hàng lời gọi)
→ sẵn sàng: trả clientInstance thật
Bạn/AI: await waitForAppStorage() rồi gọi appifio_readList / appendData…

2. Thuật ngữ

Thuật ngữNghĩaNơi thấy
Bootstrap injectScript hệ thống tự chèn vào mọi trang appKhông có nút - luôn chạy trên live/preview
appifio_clientĐối tượng gọi API Storage (DB + kho file + auth + route)Console / code AI sinh
proxyClientHàng đợi khi client chưa load xongẨn - lý do check typeof luôn “có”
waitForAppStorage()Promise chờ client sẵn sàngGlobal helper bootstrap
encoded_key / api_keyToken phiên trang (không phải admin token)Tab Backend · “API key backend của bạn”

3. Các bước kiểm chứng (không chuyên cũng làm được)

  1. Mở Creator → tab "Backend" - xác nhận có API key / Easy hoặc Advanced.
  2. Mở preview "Hiện tại" (sau khi đã Lưu) → F12 Console → gõ: typeof appifio_client → luôn ra "object" (getter), không phải undefined.
  3. Gõ: await waitForAppStorage() rồi thử await appifio_client.appifio_listFiles() (hoặc method tương ứng) - nếu Advanced/Easy đúng quyền sẽ có kết quả.
  4. Trong chat, chọn mode "Coder" hoặc nhấn "Hỏi AI về backend" (tab Backend) và yêu cầu: “Dùng appifio_client có sẵn, KHÔNG định nghĩa lại class AppStorageClient”.
  5. Nếu AI tự viết class AppStorageClient hoặc fetch() thẳng endpoint → từ chối Diff (✗) và nhắc lại quy tắc tài liệu Aura Storage.

4. Đúng / Sai khi viết code

✅ Đúng❌ Sai
await waitForAppStorage() rồi gọi methodtypeof appifio_client === 'undefined'
Gọi appifio_appendData / appifio_readListTự fetch API (bỏ auth, rate limit)
Dùng mã dự án / tên link DINHDANH từ window.appifio.global.appsHardcode slug sai môi trường

5. So sánh

  • Firebase / Supabase client SDK: bạn tự import; DINHDANH inject sẵn.
  • Bubble: data layer ẩn trong visual; DINHDANH lộ API JS có chủ đích cho AI/coder.
  • WordPress REST: bạn tự auth; ở đây page session + admin token tách lớp.

6. Làm được / Không · Bảo mật

Làm được: CRUD JSON, kho file trên site, route, auth admin, upload (đúng role), backend function. Không: viết lại client; nhờ AI vô hiệu hóa giới hạn gửi; đọc mật khẩu dạng rõ.

Bảo mật: API key tab Backend scoped theo app - không dán công khai; phân biệt page api_key với admin token sau login.

7. Vấn đề thường gặp

Tình huốngXử lý
Code “chạy sớm” lỗiawait waitForAppStorage(); DOMContentLoaded đã được bootstrap xếp hàng
AI tạo client mớiReject Diff; nhắc dùng appifio_client sẵn có (không viết lại thư viện)
Easy vs Advanced lệch hành viXem tab Backend · bài T06

8. Lời khuyên · Checklist

  • Prompt cố định: “Dùng appifio_client có sẵn, không rewrite method appifio_*”.
  • Luôn try/catch + hiện thông báo thân thiện khi bị giới hạn gửi.
  1. Bạn biết vì sao typeof appifio_client === 'undefined' luôn sai?
  2. Bạn mở được tab Backend và thấy API key?

Tiếp: T03 - Flat JSON vs Indexed