مستندات فیکارو
فیکارو یک 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 هیچوقت خروجی حدسی یک مدل نیست. جزئیات در مفاهیم پایه.