فصل ۵: فانکشنها: کد روی سروردرس ۱۹ از ۲۳
کلید محرمانه و سرویس بیرونی
سرفصلهای دوره۷ فصل۰ از ۲۳ درس کامل شده
فصل ۱
شروع با API
یک فروشگاه کوچک: اولین جدول، اولین درخواست از ترمینال، و همان داده روی صفحهی سایت خودتان.
۳ درس۱۲ دقیقه
فصل ۲
کاربرهای اپ و دسترسی
ثبتنام و ورود، ماندن در حساب، توکنها، نقشها، و اینکه هر کاربر فقط دادهی خودش را ببیند.
۶ درس۲۰ دقیقه
فصل ۳
کار با داده
یک فروشگاه کامل از روی قالب، و هر چه با دادههایش میشود کرد؛ همه با بکاند آماده.
۶ درس۱۷ دقیقه
فصل ۴
قانونها: منطق بدون کد
قاعدههای کسبوکار کنار جدول: جلوی دادهی نادرست را بگیرید، یا بگذارید فیکارو خودش کاری انجام دهد.
۱ درس۴ دقیقه
فصل ۵
فانکشنها: کد روی سرور
کد کوتاهی که روی سرور فیکارو اجرا میشود؛ فقط برای کاری که API آماده انجام نمیدهد.
۳ درس۱۰ دقیقه
فصل ۶
ساخت با هوش مصنوعی
یک بکاند کامل با توصیف فارسی کسبوکار، و تغییرش بعدها با یک جمله.
۲ درس۷ دقیقه
فصل ۷
نگهداری و هزینه
وقتی اپ کار نمیکند علت را از خود فیکارو بپرسید، و بدانید هزینهی هر پروژه از کجا و چطور کم میشود.
۲ درس۵ دقیقه
کلید یک سرویس بیرونی (مثل پنل پیامک) را در کلیدهای محرمانهی پروژه نگه میداریم و فانکشن فرم تماس با `ctx.http.post` و همان کلید، سرویس را صدا میزند؛ کلیدی که نه در صفحه است و نه در کد.
در این درس یاد میگیرید
- نگه داشتن کلید یک سرویس بیرونی در کلیدهای محرمانهی پروژه
- خواندن آن در فانکشن با
ctx.secrets - صدا زدن سرویس بیرونی با
ctx.http.post
برای ادامه بخوانید
- مدت
- ۲ دقیقه۳ قدم
- پیشنیاز
- درس ۱۷: فرم تماس با یک فانکشن
- فایلها
- لازم دارید
- یک حساب رایگان فیکارو، یک ویرایشگر متن و یک مرورگر
روی هر قدم بزنید تا ویدیو همانجا برود.
contact.js
۱۳ خط
بهجای YOUR_KEY کلید فقط خواندنی پروژهی خودتان را بگذارید، فایل را ذخیره کنید و در مرورگر باز کنید.
// فرم تماس: بازدیدکنندهی بدون حساب پیام میفرستد
const { email, message } = ctx.request.body || {};
// ذخیره در جدول «پیام تماس»، از طرف پروژه
const saved = ctx.db.admin.create("contact_message", { email, message });
// خبر به سرویس پیامک؛ کلیدش فقط در کلیدهای محرمانهی پروژه است
ctx.http.post("SMS_API_URL", {
to: "09120000000",
text: "پیام تازه از " + email,
}, { headers: { Authorization: "Bearer " + ctx.secrets.SMS_KEY } });
ctx.respond(201, { id: saved.id });هر چه گوینده میگوید، بهصورت متن. روی هر زمان بزنید تا ویدیو همانجا برود.
از منوی کناری «فانکشنها» را باز کنید.
بالای فهرست فانکشنها، «secrets» را بزنید.کلیدهایی که کد میخواند و هیچکس نمیبیند.
نامش را
SMS_KEYبگذارید.و مقدارش را، همان کلیدی که سرویس پیامک به شما داده.بعد از ذخیره، دیگر هیچجا نشان داده نمیشود؛ فقط میشود عوضش کرد یا پاکش کرد.
«افزودن» را بزنید.
کلید ذخیره شد.در کد با
ctx.secrets.SMS_KEYخوانده میشود.فانکشن
contactرا باز کنید.کد تازه را جای کد قبلی paste کنید.متن کاملش در صفحهی همین آموزش هست.
این چند خط، پیامک را با
ctx.http.postمیفرستند.به جای این آدرس، آدرس سرویس پیامک خودتان را بگذارید؛ اینجا برای امتحان، یک آدرس webhook.site است.و کلید، از
ctx.secretsمیآید.نه در کد صفحه است و نه در کد فانکشن؛ کسی که کد را ببیند، کلید را نمیبیند.«ذخیره» را بزنید.
در صفحهی فروشگاه، یک پیام بفرستید.
پیام رسید؛ مثل قبل.ولی این بار فانکشن به سرویس پیامک هم خبر داد.
این همان چیزی است که سرویس پیامک دریافت کرد.متن پیامک در بدنه، و کلید در هدر
Authorization؛ کلیدی که هیچوقت به مرورگر بازدیدکننده نرسید.
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.