به محتوای اصلی

مستندات فیکارو

فیکارو یک BaaS هوش مصنوعی است و از یک پنل، بک‌اند واقعی می‌سازد: API، دیتابیس PostgreSQL، مستندات، کلید و محیط تست — بدون کدنویسی و بدون اینکه سرور یا دیپلوی را لمس کنید. مدل داده را یا به فارسی توصیف می‌کنید تا هوش مصنوعی بسازدش، یا خودتان تعریف می‌کنید — و همان لحظه اندپوینت‌ها، مستندات و کالکشن Postman پروژه ساخته می‌شوند.

هر پروژه یک آدرس اختصاصی می‌گیرد:

https://api.fikaro.ir/{slug}/v1/{entity}

این بخش دربارهٔ خودِ فیکاروست: پنل، مفاهیم و روش کار. مستندات کامل و اختصاصیِ هر پروژه — مرجع اندپوینت‌ها، مثال کد و آزمایش زنده — به‌صورت خودکار داخل همان پروژه ساخته می‌شود.

از کجا شروع کنم؟

  • شروع سریع — از ثبت‌نام تا اولین درخواست، قدم به قدم.
  • دستیار هوش مصنوعی — توصیف فارسی کسب‌وکار، پیشنهاد جدول‌ها و سطح دسترسی، تأیید شما، استقرار همان لحظه.
  • ایجنت‌های هوش مصنوعی — ایجنتی با آدرس API و کلید خودش، بدون پروژه، که از روی دانسته‌ها و جدول‌های خودتان جواب می‌دهد.
  • مفاهیم پایه — پروژه، موجودیت، اعمال تغییرات و کلیدها؛ تصویر کلی در پنج دقیقه.
  • مدل داده — موجودیت‌ها، فیلدها، قیدها، فیلد محاسباتی و روابط.
  • قوانین — منطق تجاری بدون کد: اعتبارسنجی، محرک و فیلد محاسباتی.
  • فانکشن‌ها — آدرس HTTP با کد جاوااسکریپت خودتان، برای کاری که API آماده انجام نمی‌دهد: فرم تماس، وب‌هوک درگاه، سرویس بیرونی.
  • کلیدها و احراز هویت — کلید API پروژه، و ورود کاربران نهایی.
  • آموزش ورود و توکن — ثبت‌نام، ورود، رفرش توکن و خروج کاربران اپ، قدم به قدم.
  • کار با API — فیلتر، مرتب‌سازی، صفحه‌بندی، روابط و قالب خطاها.
  • فایل‌ها — آپلود عکس و فایل با یک درخواست، آدرس عمومی و خصوصی، و تصویر کوچک با ?w=.
  • وب‌هوک — خبر ساخت، ویرایش و حذف رکورد به سرویس خودتان، با امضای HMAC.
  • دامنه‌ی اختصاصی — همان API روی دامنه‌ی خودتان، با گواهی HTTPS خودکار.
  • خروجی‌ها و SDK — Postman، Bruno و کتابخانه‌های کلاینت Flutter، Kotlin و Swift.

فیکارو چطور کار می‌کند؟

ساخت با هوش مصنوعی، اجرا با موتور قطعی. فیکارو کد تولید نمی‌کند؛ یک موتور اجرایی اسکیمای پروژهٔ شما را می‌خواند و درخواست‌ها را همان لحظه اجرا می‌کند — چه آن اسکیما را هوش مصنوعی ساخته باشد، چه خودتان. نتیجه این است که افزودن یا حذف یک فیلد فقط تغییر تعریف است — بدون build مجدد، بدون ری‌استارت و بدون توقف سرویس — و پاسخ API هیچ‌وقت خروجی حدسی یک مدل نیست. جزئیات در مفاهیم پایه.