Mục lục

DINHDANH Creator · Bài AM07 · API REFERENCE §6 · 1 method (+ Secrets UI)
Hàm máy chủ
executeBackendFunction - đầy đủ cấu trúc
executeBackendFunction - đầy đủ cấu trúc
Chạy logic nhạy cảm phía máy chủ (gửi mail, đọc secret…) - không để chìa khóa lộ trên trang khách.
Method duy nhất §6
appifio_executeBackendFunction(functionName, params?)
Việc làm: Gọi một hàm đã lưu trong backend/functions/{tên}.js trên máy chủ.
Ai được gọi: Public khi chưa bật siết bảo mật CMS. Khi bật → cần đăng nhập quản trị (Admin+).
Tham số:
functionName- chỉ chữ/số/_/- (vd.sendMail,greetUser). Phải khớp tên file hàm.params- object tuỳ chọn → trong handler đọc được quaappifio.params.
Cách gọi:
const res = await appifio_client.appifio_executeBackendFunction('sendMail', {
to: 'khach@mail.com',
subject: 'Xin chào'
});
if (res.success) {
console.log(res.data.result);
console.log(res.data.function_name, res.data.execution_time);
} else {
alert(res.message || 'Hàm máy chủ lỗi');
}Kết quả trả về:
{ success, data: {
function_name: string,
result: any, // kết quả handler trả về
execution_time: number // thời gian chạy
} }Lưu ý:
- Có giới hạn số lần gọi - không spam từ trang.
- Chi tiết viết hàm + secrets: SECTION BACKEND FUNCTION & SECRETS trong TXT.
- Khi CMS siết quyền: gọi sau
validateAdminSession()(AM06).
Secrets trên UI (không phải method appifio_*)
- Tab Backend → Secrets manager → Thêm secret (đặt tên dễ nhớ).
- Trong handler máy chủ mới đọc được secret - không đọc file secret bằng
readFsFiletừ trang.
Khung file hàm (tạo bằng writeFsFile - AM04)

// backend/functions/greetUser.js
exports.handler = async function (appifio) {
const { name } = appifio.params || {};
if (!name) return { success: false, error: 'Thiếu name' };
// Secret (nếu cần): appifio.secrets.get('TEN_SECRET')
return { success: true, message: 'Xin chào ' + name };
};
await appifio_client.appifio_writeFsFile(
'backend/functions/greetUser.js',
codeString
);Không nhét mật khẩu SMTP / key thanh toán vào HTML trang - chỉ Secrets manager + hàm máy chủ.
Checklist §6: executeBackendFunction = 1/1 (+ quy trình Secrets UI)
AM08 - Helper đồng bộ (§7 - 5 hàm)
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Loạt Method · AM07