فصل ۱: شروع با APIدرس ۳ از ۲۳
API شما، روی صفحهی خودتان
سرفصلهای دوره۷ فصل۰ از ۲۳ درس کامل شده
فصل ۱
شروع با API
یک فروشگاه کوچک: اولین جدول، اولین درخواست از ترمینال، و همان داده روی صفحهی سایت خودتان.
۳ درس۱۲ دقیقه
فصل ۲
کاربرهای اپ و دسترسی
ثبتنام و ورود، ماندن در حساب، توکنها، نقشها، و اینکه هر کاربر فقط دادهی خودش را ببیند.
۶ درس۲۰ دقیقه
فصل ۳
کار با داده
یک فروشگاه کامل از روی قالب، و هر چه با دادههایش میشود کرد؛ همه با بکاند آماده.
۶ درس۱۷ دقیقه
فصل ۴
قانونها: منطق بدون کد
قاعدههای کسبوکار کنار جدول: جلوی دادهی نادرست را بگیرید، یا بگذارید فیکارو خودش کاری انجام دهد.
۱ درس۴ دقیقه
فصل ۵
فانکشنها: کد روی سرور
کد کوتاهی که روی سرور فیکارو اجرا میشود؛ فقط برای کاری که API آماده انجام نمیدهد.
۳ درس۱۰ دقیقه
فصل ۶
ساخت با هوش مصنوعی
یک بکاند کامل با توصیف فارسی کسبوکار، و تغییرش بعدها با یک جمله.
۲ درس۷ دقیقه
فصل ۷
نگهداری و هزینه
وقتی اپ کار نمیکند علت را از خود فیکارو بپرسید، و بدانید هزینهی هر پروژه از کجا و چطور کم میشود.
۲ درس۵ دقیقه
جدول «محصول» را عمومی میکنیم، یک کلید فقط خواندنی میسازیم و با یک فایل HTML ساده، فهرست محصولها را روی صفحهی خودمان نشان میدهیم؛ زنده، با هر تغییر در پنل.
در این درس یاد میگیرید
- عمومی کردن خواندن یک جدول
- ساختن کلید فقط خواندنی برای سایت
- نمایش دادهی API در یک صفحهی HTML با
@fikaro/client - دیدن تغییرات پنل، زنده روی سایت
- مدت
- ۴ دقیقه۴ قدم
- پیشنیاز
- درس ۲: API شما، از کد خودتان
- فایلها
- لازم دارید
- یک حساب رایگان فیکارو، یک ویرایشگر متن و یک مرورگر
روی هر قدم بزنید تا ویدیو همانجا برود.
index.html
۲۳ خط
بهجای YOUR_KEY کلید فقط خواندنی پروژهی خودتان را بگذارید، فایل را ذخیره کنید و در مرورگر باز کنید.
<!doctype html>
<html lang="fa" dir="rtl">
<meta charset="utf-8">
<body style="font: 24px/2 Tahoma, sans-serif; padding: 40px">
<h1>محصولات فروشگاه من</h1>
<ul id="products"></ul>
<script type="module">
import { createClient } from "https://cdn.jsdelivr.net/npm/@fikaro/client/+esm";
const fikaro = createClient({
project: "my-shop",
key: "YOUR_KEY",
});
const { data } = await fikaro.from("product").list();
for (const p of data) {
const li = document.createElement("li");
li.textContent = `${p.name} — ${p.price.toLocaleString("fa-IR")} تومان`;
document.querySelector("#products").append(li);
}
</script>هر چه گوینده میگوید، بهصورت متن. روی هر زمان بزنید تا ویدیو همانجا برود.
از منوی کناری «جدولها» را باز کنید.همان نقشهی جدولها که در قسمت ۱ ساختیم.
روی کارت «محصول» بزنید.تنظیمات همین جدول باز میشود.
اینجا تعیین میکنید چه کسی میتواند رکوردهای این جدول را بخواند.الان فقط کسانی که وارد حساب شدهاند فهرست محصولها را میبینند.
«همه، حتی بدون ورود» را انتخاب کنید.فهرست محصولهای یک فروشگاه را همه باید ببینند، حتی بدون حساب.
حالا «ذخیره و اعمال» را بزنید.
«اعمال» را بزنید.فقط دسترسیِ خواندن عوض میشود؛ هیچ دادهای تغییر نمیکند.
جدول «محصول» حالا عمومی است.
از منوی کناری «کلیدهای API» را باز کنید.
«کلید جدید» را بزنید.
یک نام برای کلید بنویسید؛ مثلاً «سایت من».نام فقط برای این است که بعداً بدانید کلید مال کجاست.
«فقط خواندنی» را انتخاب کنید.این کلید فقط جدولهای عمومی را میخواند و چیزی نمینویسد؛ اگر کسی آن را در کد صفحه ببیند، خطری ندارد.
«ساخت» را بزنید.
این کلید فقط خواندنی شماست.این کلید هر وقت بخواهید از صفحهی کلیدها دوباره کپی میشود.
«کپی کلید» را بزنید.کلید حالا در حافظهی کامپیوتر است؛ در فایل صفحه paste میکنیم.
این فایل index.html است؛ متن کاملش را از صفحهی همین آموزش در fikaro.ir کپی کنید.با هر ویرایشگری میشود ذخیرهاش کرد، حتی Notepad.
این خط، کتابخانهی فیکارو را از اینترنت بار میکند.لازم نیست چیزی نصب کنید.
اینجا نشانی پروژه و کلید را میدهیم.
my-shopهمان نشانیای است که در قسمت ۱ برای پروژه انتخاب کردیم.بهجای
YOUR_KEY، کلیدی را که کپی کردید paste کنید (Ctrl+V).همان کلید فقط خواندنی که همین حالا ساختیم.این خط، فهرست محصولها را از API میگیرد.همان کاری که در قسمت ۱ با «ارسال» در «آزمایش زنده» کردیم.
و این چند خط، هر محصول را یک ردیف در صفحه میکنند.نام و قیمت، همان دو فیلد جدول «محصول».
فایل را ذخیره کنید (Ctrl+S).
فایل را در مرورگر باز کنید؛ کافی است رویش دوبار کلیک کنید.این صفحه همین حالا فهرست محصولها را از API فیکارو خواند.
این محصول فروشگاه شماست، روی صفحهی خودتان.همان محصولی که در قسمت ۱ در پنل ساختیم.
حالا به پنل برگردید و از منوی کناری «رکوردها» را باز کنید.
یک محصول تازه اضافه کنید: «رکورد جدید» را بزنید.
نام و قیمت را بنویسید.
«ساخت رکورد» را بزنید.
به صفحهی خودتان برگردید و آن را تازه کنید (F5).
محصول تازه هم آمد.هر تغییری در پنل، همان لحظه در صفحهی شما هم دیده میشود؛ بدون اینکه کد را عوض کنید.
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.