آموزشهای ویدیویی
مسیرهای واقعی پنل، قدمبهقدم و با زیرنویس فارسی. همان صفحههایی را میبینید که بعد از ثبتنام میبینید؛ هیچچیز شبیهسازی نشده است.
۳ آموزشمجموعاً ۱۲ دقیقهبدون صدا، با زیرنویس فارسی
اولین API شما، از صفر
از ساخت حساب تا اولین جواب API: یک پروژهی خالی میسازیم، جدول «محصول» را با دو فیلد تعریف میکنیم، اعمالش میکنیم و اولین جواب JSON را میگیریم.
این ویدیوها صدا ندارند؛ همهی توضیحها زیرنویساند، پس بیصدا هم میشود دیدشان.
قدمها
روی هر قدم بزنید تا ویدیو همانجا برود.
متن کامل ویدیو۴۱ خطروی هر زمان بزنید تا ویدیو همانجا برود
شمارهی موبایلتان را بنویسید و «ادامه» را بزنید.حساب با همین شماره ساخته میشود.
کد ۶ رقمی را که پیامک شد وارد کنید.بعد از رقم ششم، خودکار وارد حسابتان میشوید.
حساب ساخته شد. روی «اولین پروژه را بسازید» بزنید.اعتبار هدیهی حساب تازه، هزینهی روزهای اول پروژه را میدهد.
یک نام برای پروژه بنویسید.این نام فقط برای خودتان است و بعداً قابل تغییر است.
«از صفر» را انتخاب کنید.یعنی جدولها را خودتان، یکییکی تعریف میکنید.
«بعدی» را بزنید.
پلن «اسپرسو» از قبل انتخاب شده است.برای یادگیری و پروژههای کوچک کافی است و هزینهاش از اعتبار هدیه کم میشود.
«بعدی» را بزنید.
یک نشانی انگلیسی برای پروژه بنویسید؛ مثلاً my-shopفقط حروف کوچک انگلیسی، عدد و خط تیره.
آدرس API شما از همین نشانی ساخته میشود.بعد از ساخت پروژه، این نشانی دیگر عوض نمیشود.
«ساخت پروژه» را بزنید.ساخت پروژه چند ثانیه طول میکشد.
پروژه ساخته شد و API آن همین حالا روشن است.این نشانی پایهی API شماست. «رفتن به پروژه» را بزنید.
این پنل پروژهی شماست. از منوی کناری «جدولها» را باز کنید.همهی بخشهای پروژه در همین منوی سمت راستاند.
جدولهای پروژه اینجا روی یک نقشه دیده میشوند.هر کارت یک جدول است و ردیفهای داخلش، ستونهای آن جدول.
این جدول «کاربران» است.فیکارو آن را برای ثبتنام و ورود کاربرانِ اپ شما ساخته؛ فعلاً کاری با آن نداریم.
برای جدول تازه، «موجودیت جدید» را بزنید.در فیکارو به هر جدول «موجودیت» هم میگویند.
نام فارسی جدول را بنویسید: «محصول»این نام فقط داخل پنل نمایش داده میشود.
حالا شناسهی انگلیسی را بنویسید:
productاین شناسه در آدرس API میآید:/v1/product«ایجاد» را بزنید.پنل جدول تازه باز میشود تا ستونهایش را تعریف کنید.
«فیلد جدید» را بزنید.هر فیلد یک ستون جدول است؛ مثل «نام» یا «قیمت» محصول.
فیلد اول: نام نمایشی «نام» و شناسهی
nameنوعش «متن» میماند، چون نام محصول متن است.تیک «الزامی» را بزنید.یعنی هیچ محصولی بدون نام ذخیره نمیشود.
«افزودن فیلد» را بزنید.فیلد «نام» به جدول اضافه شد و فرم برای فیلد بعدی خالی میماند.
فیلد دوم: «قیمت» با شناسهی
priceنوع این فیلد را «عدد» کنید.حالا API برای قیمت فقط عدد قبول میکند؛ متن را رد میکند.
«افزودن فیلد» را بزنید.جدول «محصول» حالا دو ستون دارد: نام و قیمت.
پنل بسته شد. حالا «ذخیره و اعمال» را بزنید.فیکارو در این لحظه جدول واقعی و API آن را میسازد.
فیکارو خلاصهی تغییرات را نشان میدهد. «اعمال» را بزنید.«ایمن» یعنی هیچ دادهای از بین نمیرود.
جدول ساخته شد.حالا ببینیم فیکارو برای این جدول چه آدرسهایی ساخته است.
روی کارت «محصول» بزنید.
زبانهی «پیشنمایش زنده» را باز کنید.
برای هر جدول، پنج آدرس API ساخته شد.بدون اینکه یک خط کد بنویسید.
GETمیخواند،POSTمیسازد،PATCHویرایش میکند وDELETEحذف.اپ شما با همین پنج آدرس با دادههای این جدول کار میکند.از منوی کناری «رکوردها» را باز کنید.رکورد یعنی یک ردیف از جدول؛ اینجا یعنی یک محصول.
جدول «محصول» هنوز خالی است. «رکورد جدید» را بزنید.
نام و قیمت محصول را بنویسید.اینها همان دو فیلدی هستند که تعریف کردیم.
«ساخت رکورد» را بزنید.اولین محصول در جدول ذخیره شد.
حالا از منوی کناری «مستندات API» را باز کنید.اینجا هر آدرس API را میشود بدون نوشتن کد امتحان کرد.
روی
GET /productبزنید.این آدرس، فهرست همهی محصولها را برمیگرداند.در بخش «آزمایش زنده»، «ارسال» را بزنید.یعنی همان کاری که اپ شما میکند: یک درخواست به API.
این جواب API است: همان محصولی که ساختید، بهصورت JSON.
nameوpriceهمان فیلدهای جدول شما هستند.
حالا نوبت خودتان است
حساب رایگان است و اعتبار هدیهی شروع، هزینهی روزهای اول پروژه را میدهد. اگر وسط کار گیر کردید، مستندات همین قدمها را با جزئیات فنی بیشتر میگوید.