فصل ۲: کاربرهای اپ و دسترسیدرس ۸ از ۲۳
ورود و توکن، از ترمینال
سرفصلهای دوره۷ فصل۰ از ۲۳ درس کامل شده
فصل ۱
شروع با API
یک فروشگاه کوچک: اولین جدول، اولین درخواست از ترمینال، و همان داده روی صفحهی سایت خودتان.
۳ درس۱۲ دقیقه
فصل ۲
کاربرهای اپ و دسترسی
ثبتنام و ورود، ماندن در حساب، توکنها، نقشها، و اینکه هر کاربر فقط دادهی خودش را ببیند.
۶ درس۲۰ دقیقه
فصل ۳
کار با داده
یک فروشگاه کامل از روی قالب، و هر چه با دادههایش میشود کرد؛ همه با بکاند آماده.
۶ درس۱۷ دقیقه
فصل ۴
قانونها: منطق بدون کد
قاعدههای کسبوکار کنار جدول: جلوی دادهی نادرست را بگیرید، یا بگذارید فیکارو خودش کاری انجام دهد.
۱ درس۴ دقیقه
فصل ۵
فانکشنها: کد روی سرور
کد کوتاهی که روی سرور فیکارو اجرا میشود؛ فقط برای کاری که API آماده انجام نمیدهد.
۳ درس۱۰ دقیقه
فصل ۶
ساخت با هوش مصنوعی
یک بکاند کامل با توصیف فارسی کسبوکار، و تغییرش بعدها با یک جمله.
۲ درس۷ دقیقه
فصل ۷
نگهداری و هزینه
وقتی اپ کار نمیکند علت را از خود فیکارو بپرسید، و بدانید هزینهی هر پروژه از کجا و چطور کم میشود.
۲ درس۵ دقیقه
بدون کتابخانه و فقط با درخواست HTTP: سارا ثبتنام میکند، با توکنش درخواست میفرستد، یک ساعت بعد جواب ۴۰۱ میگیرد، توکن تازه میگیرد و خارج میشود؛ همان درخواستهایی که اپ Flutter، Kotlin یا Swift شما میفرستد.
در این درس یاد میگیرید
- ثبتنام کاربر اپ با یک درخواست HTTP، بدون هیچ کتابخانهای
- فرستادن درخواست از طرف کاربر با
access_tokenدر هدرAuthorization - شناختن
401با کدinvalid_tokenو گرفتن یک جفت توکن تازه از/auth/refresh - خروجی که نشست را روی سرور هم باطل میکند، و
refresh_token_revokedبعد از آن
- مدت
- ۴ دقیقه۵ قدم
- پیشنیاز
- درس ۲: API شما، از کد خودتان
- فایلها
- ندارد
- لازم دارید
- یک حساب رایگان فیکارو، یک ترمینال با curl
روی هر قدم بزنید تا ویدیو همانجا برود.
این درس فایلی ندارد.
برای این درس یک حساب رایگان فیکارو و یک ترمینال با curl لازم دارید؛ دستورها در خود ویدیو و در «منابع» همین درس هستند.
ساخت حساب رایگانهر چه گوینده میگوید، بهصورت متن. روی هر زمان بزنید تا ویدیو همانجا برود.
از منوی کناری «رکوردها» را باز کنید.
جدول «کاربران» را انتخاب کنید.کاربرهای اپ شما اینجا هستند؛ هنوز کسی ثبتنام نکرده.
این نشانی پایهی ورود کاربران پروژه است.ثبتنام، ورود، تازه کردن توکن و خروج، همه زیر همین نشانیاند.
ترمینال را باز کنید. سارا ثبتنام میکند: یک درخواست
POSTبه/auth/signup.با ایمیل و رمز. مسیرهای ورود کلید API نمیخواهند.جواب: مشخصات سارا و دو توکن.ورود هم همین است: همین بدنه به
/auth/login، و همین جواب.access_tokenیک ساعت اعتبار دارد وrefresh_tokenسی روز.اپ هر دو را در حافظهی امن دستگاه نگه میدارد.در پنل، سارا حالا در جدول «کاربران» است.نقشش «کاربر» است؛ همهی ثبتنامها با این نقش شروع میشوند.
access_tokenدر هدرAuthorizationمیرود، بعد از کلمهیBearer.توکن را کوتاه نشان دادهایم؛ در اصل چند صد حرف است.سرور میداند این درخواست از طرف ساراست.
/auth/meمشخصات صاحب توکن را برمیگرداند.یک ساعت بعد، همان درخواست را دوباره میفرستیم.برای اینکه یک ساعت منتظر نمانیم، توکنی ساختیم که وقتش گذشته است.
جواب
401با کدinvalid_token: توکن دسترسی دیگر معتبر نیست.اپ کاربر را بیرون نمیاندازد؛ فقط توکن را تازه میکند.refresh_tokenرا به/auth/refreshبفرستید.این درخواست هدرAuthorizationندارد؛ توکن در بدنه است.یک جفت توکن تازه. هر دو را جای قبلیها بگذارید.مهلت سیروزهی
refresh_tokenاز همین لحظه دوباره شمرده میشود.همان درخواست، این بار با
access_tokenتازه.دوباره جواب میدهد.در اپ این کار خودکار است: یک
401، یک بار تازه کردن، یک بار فرستادن دوباره.خروج: یک درخواست
POSTبه/auth/logout، باaccess_token.این دستور فقط وضعیت جواب را چاپ میکند.204یعنی انجام شد.نشستهای سارا روی همهی دستگاههایش باطل شد.حالا
refresh_tokenرا دوباره امتحان کنیم.رد شد:
refresh_token_revoked، با پیامی که میگوید چرا.اپ هر دو توکن را پاک میکند و صفحهی ورود را نشان میدهد.در پنل، «راهاندازی ورود» را بزنید.همانجا کنار جدول «کاربران».
کد کلاینت، با نشانی همین پروژه.Flutter، Kotlin، Swift و TypeScript؛ هر کدام در یک زبانه.
این تابع همان کاری را میکند که با دست کردیم.جواب
401که آمد، یک بار توکن را تازه میکند و درخواست را یک بار دیگر میفرستد.متن کامل همین آموزش، با کد هر چهار زبان، در مستندات فیکارو است.صفحهی «آموزش ورود و توکن».
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.