فصل ۲: کاربرهای اپ و دسترسیدرس ۵ از ۲۳
ماندن در حساب: توکنها و خروج
سرفصلهای دوره۷ فصل۰ از ۲۳ درس کامل شده
فصل ۱
شروع با API
یک فروشگاه کوچک: اولین جدول، اولین درخواست از ترمینال، و همان داده روی صفحهی سایت خودتان.
۳ درس۱۲ دقیقه
فصل ۲
کاربرهای اپ و دسترسی
ثبتنام و ورود، ماندن در حساب، توکنها، نقشها، و اینکه هر کاربر فقط دادهی خودش را ببیند.
۶ درس۲۰ دقیقه
فصل ۳
کار با داده
یک فروشگاه کامل از روی قالب، و هر چه با دادههایش میشود کرد؛ همه با بکاند آماده.
۶ درس۱۷ دقیقه
فصل ۴
قانونها: منطق بدون کد
قاعدههای کسبوکار کنار جدول: جلوی دادهی نادرست را بگیرید، یا بگذارید فیکارو خودش کاری انجام دهد.
۱ درس۴ دقیقه
فصل ۵
فانکشنها: کد روی سرور
کد کوتاهی که روی سرور فیکارو اجرا میشود؛ فقط برای کاری که API آماده انجام نمیدهد.
۳ درس۱۰ دقیقه
فصل ۶
ساخت با هوش مصنوعی
یک بکاند کامل با توصیف فارسی کسبوکار، و تغییرش بعدها با یک جمله.
۲ درس۷ دقیقه
فصل ۷
نگهداری و هزینه
وقتی اپ کار نمیکند علت را از خود فیکارو بپرسید، و بدانید هزینهی هر پروژه از کجا و چطور کم میشود.
۲ درس۵ دقیقه
چرا کاربر با تازه کردن صفحه از حساب بیرون میافتد و چطور با یک خط وارد میماند؛ توکن دسترسی و توکن تازهسازی چه هستند، پیام فارسی برای خطای ورود، تازه کردن توکن و خروج. با کمی CSS برای ظاهر صفحه.
در این درس یاد میگیرید
- نگه داشتن کاربر در حساب بعد از تازه کردن صفحه، با
browserStorage() - فرق توکن دسترسی (یک ساعت) و توکن تازهسازی (سی روز)
- پیام فارسیِ ساده برای هر خطای ورود، با
err.code - تازه کردن توکن و خروجی که توکن را روی سرور هم باطل میکند
- مدت
- ۴ دقیقه۴ قدم
- پیشنیاز
- درس ۴: کاربرهای اپ شما
- فایلها
- لازم دارید
- یک حساب رایگان فیکارو، یک ویرایشگر متن و یک مرورگر
روی هر قدم بزنید تا ویدیو همانجا برود.
index.html
۱۲۳ خط
بهجای YOUR_KEY کلید فقط خواندنی پروژهی خودتان را بگذارید، فایل را ذخیره کنید و در مرورگر باز کنید.
<!doctype html>
<html lang="fa" dir="rtl">
<meta charset="utf-8">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vazirmatn@33.0.3/Vazirmatn-font-face.css">
<style>
body { font: 19px/1.9 Vazirmatn, Tahoma, sans-serif; background: #f5f5f4; color: #1c1917;
max-width: 1040px; margin: 0 auto; padding: 24px; }
main { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; align-items: start; }
.card { background: #fff; border: 1px solid #e7e5e4; border-radius: 14px; padding: 20px; }
h1 { margin: 0 0 16px; } h2 { margin: 0 0 8px; font-size: 20px; }
input { font: inherit; width: 100%; box-sizing: border-box; margin-bottom: 10px;
padding: 6px 12px; border: 1px solid #d6d3d1; border-radius: 8px; }
button { font: inherit; padding: 4px 16px; border: 0; border-radius: 8px;
background: #ea580c; color: #fff; cursor: pointer; }
button.quiet { background: #f0efee; color: #1c1917; }
ul { list-style: none; padding: 0; margin: 0 0 16px; }
li { display: flex; justify-content: space-between; align-items: center;
padding: 6px 0; border-top: 1px solid #f0efee; }
dl { display: grid; grid-template-columns: auto 1fr; gap: 4px 16px; margin: 0 0 16px; }
dd { margin: 0; text-align: right; color: #57534e; }
dd[dir] { font-family: monospace; }
.error { color: #b91c1c; margin: 0; }
</style>
<body>
<h1>فروشگاه من</h1>
<main>
<form id="auth" class="card">
<h2>ورود به حساب</h2>
<input id="email" type="email" placeholder="ایمیل">
<input id="password" type="password" placeholder="رمز (حداقل ۸ حرف)">
<button id="login">ورود</button> <button id="signup" class="quiet">ثبتنام</button>
<p id="error" class="error"></p>
</form>
<section id="session" class="card" hidden>
<h2>سلام <span id="who"></span></h2>
<dl>
<dt>توکن دسترسی</dt><dd id="access" dir="ltr"></dd>
<dt>معتبر تا</dt><dd id="expires"></dd>
<dt>توکن تازهسازی</dt><dd id="refresh" dir="ltr"></dd>
</dl>
<button id="renew" class="quiet">تازه کردن توکن</button> <button id="logout">خروج</button>
</section>
<section class="card">
<h2>محصولات</h2>
<ul id="products"></ul>
<h2>علاقهمندیهای من</h2>
<ul id="favorites"></ul>
</section>
</main>
<script type="module">
import { createClient, browserStorage } from "https://cdn.jsdelivr.net/npm/@fikaro/client/+esm";
const fikaro = createClient({
project: "my-shop",
key: "YOUR_KEY",
storage: browserStorage(),
});
const $ = (id) => document.getElementById(id);
const { data: products } = await fikaro.from("product").list();
const MESSAGES = {
invalid_credentials: "ایمیل یا رمز اشتباه است.",
email_taken: "این ایمیل قبلاً ثبت شده؛ «ورود» را بزنید.",
validation_failed: "ایمیل درست و رمز حداقل ۸ حرفی لازم است.",
rate_limited: "رمز چند بار اشتباه زده شد؛ ۱۵ دقیقه صبر کنید.",
};
async function show() {
const s = fikaro.auth.session;
$("auth").hidden = !!s;
$("session").hidden = !s;
if (s) {
$("who").textContent = s.user.email;
$("access").textContent = "…" + s.accessToken.slice(-12);
$("expires").textContent = new Date(s.expiresAt).toLocaleTimeString("fa-IR");
$("refresh").textContent = "…" + s.refreshToken.slice(-12);
}
$("products").replaceChildren(...products.map((p) => {
const li = document.createElement("li");
li.textContent = `${p.name} — ${p.price.toLocaleString("fa-IR")} تومان`;
const heart = document.createElement("button");
heart.textContent = "♥";
heart.className = "quiet";
heart.onclick = async () => {
await fikaro.from("favorite").create({ product_id: p.id });
show();
};
if (s) li.append(heart);
return li;
}));
const { data: mine } = s ? await fikaro.from("favorite").list() : { data: [] };
$("favorites").replaceChildren(...mine.map((f) => {
const li = document.createElement("li");
li.textContent = products.find((p) => p.id === f.product_id)?.name ?? "؟";
return li;
}));
}
const signIn = (how) => async (e) => {
e.preventDefault();
$("error").textContent = "";
try {
await fikaro.auth[how]($("email").value, $("password").value);
$("auth").reset();
show();
} catch (err) {
$("error").textContent = MESSAGES[err.code] ?? err.message;
}
};
$("login").onclick = signIn("login");
$("signup").onclick = signIn("signup");
$("renew").onclick = async () => { await fikaro.auth.refresh(); show(); };
$("logout").onclick = async () => { await fikaro.auth.logout(); show(); };
// اگر نشستِ ذخیرهشده دیگر معتبر نباشد، فیکارو خودش پاکش میکند.
if (fikaro.auth.session) await fikaro.auth.me().catch(() => {});
show();
</script>هر چه گوینده میگوید، بهصورت متن. روی هر زمان بزنید تا ویدیو همانجا برود.
علی در قسمت قبل وارد شد.نامش بالای صفحه است.
صفحه را تازه کنید (F5).
علی از حساب بیرون افتاد.کتابخانهی فیکارو نشستِ کاربر را فقط تا وقتی صفحه باز است نگه میدارد، مگر اینکه بگوییم کجا ذخیرهاش کند.
این index.html تازه است؛ متن کاملش را از صفحهی همین آموزش در fikaro.ir کپی کنید.کلید فقط خواندنی را دوباره بهجای
YOUR_KEYبگذارید.بخش
styleفقط ظاهر صفحه است: فونت وزیرمتن، کارتها و دکمهها.رنگها و اندازهها را هر طور دوست دارید عوض کنید.این خط، نشست کاربر را در مرورگر ذخیره میکند.حالا با تازه کردن صفحه، یا حتی بستن مرورگر، کاربر وارد میماند.
بعد از ورود، فیکارو دو توکن به اپ شما میدهد.توکن دسترسی یک ساعت اعتبار دارد و با هر درخواست میرود؛ توکن تازهسازی سی روز، فقط برای گرفتن توکن دسترسیِ تازه.
موقع باز شدن صفحه، این خط از سرور میپرسد نشستِ ذخیرهشده هنوز معتبر است یا نه.اگر توکن دسترسی تمام شده باشد، فیکارو خودش با توکن تازهسازی یکی نو میگیرد.
هر خطا با
err.codeیک پیام فارسیِ ساده میگیرد.متن خطای سرور برای برنامهنویس است؛ به کاربر پیام خودتان را نشان بدهید.فایل را ذخیره کنید (Ctrl+S).
صفحه را تازه کنید.همان فروشگاه، مرتبتر.
ایمیل سارا را بنویسید، ولی رمز را عمداً اشتباه.
«ورود» را بزنید.
یک پیام فارسیِ ساده، بهجای یک خطای فنی.همان پیامی که برای
invalid_credentialsنوشتیم.حالا رمز درست را بنویسید و «ورود» را بزنید.
سارا وارد شد؛ این کارت، توکنهای او را نشان میدهد.فقط دوازده حرف آخر هر توکن را نشان میدهیم؛ توکن کامل خیلی بلند است.
علاقهمندی سارا از قسمت قبل هم سر جایش است.
حالا صفحه را تازه کنید (F5).
سارا هنوز وارد است.نشستش در مرورگر ذخیره شده بود؛ با همان یک خط.
«تازه کردن توکن» را بزنید.در اپ واقعی لازم نیست؛ فیکارو خودش این کار را میکند. این دکمه فقط برای دیدنش است.
توکن دسترسی عوض شد و زمان اعتبارش جلو رفت.یک ساعت از همین حالا.
«خروج» را بزنید.
توکنها از مرورگر پاک شدند، و توکن تازهسازی روی سرور هم باطل شد.اگر کسی آن را برداشته باشد، دیگر به کارش نمیآید.
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.