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

بک‌اند آماده آگهی‌های نیازمندی

آگهی و دسته‌بندی عمومی با جستجوی فارسی، آگهی‌های من و علاقه‌مندی‌ها خصوصی.

ماه اول رایگانبا پلناسپرسو

اعتبار هدیهٔ ثبت‌نام هزینه‌اش را می‌دهد؛ لازم نیست حتی یک تومان پرداخت کنید.

با دکمهٔ زیر، پروژه روی پلن اسپرسو شروع می‌شود. پلن پیشنهادی این قالب کاپوچینو است، با ۱۵ روز رایگان؛ در قدم پلن با یک کلیک انتخابش می‌کنید.

مناسب برای

  • نیازمندی‌های کالای دست دوم
  • اپ آگهی محلی با جستجو
  • اجاره و خرید و فروش

همان لحظهٔ ساخت، این‌ها در جدول هستند

آگهی/v1/listing
  • گوشی سامسونگ گلکسی A54 در حد نو۱۴٬۵۰۰٬۰۰۰ تومان
  • تبلت لنوو ۱۰ اینچی برای مطالعهکارکرده
  • یخچال فریزر امرسان سفید۹٬۸۰۰٬۰۰۰ تومان

۴ جدولورود کاربران۲ قانون۹ ردیف نمونه

با این قالب چه می‌شود ساخت

کارهایی که اپ یا سایت شما از روز اول روی همین بک‌اند انجام می‌دهد.

  • جستجوی آگهی

    «?search=» روی عنوان و توضیحات کار می‌کند و املای فارسی را خودش یکسان می‌کند. تا وقتی ایندکس ساخته نشده، همان نتیجه با سرعت کمتر برمی‌گردد و هدر X-Search-Degraded می‌آید.

    GET /v1/listing
  • فیلتر روی دسته و شهر

    جستجو را با فیلتر ترکیب کنید: search=یخچال&filter[city_id]=…

    GET /v1/listing
  • ثبت آگهی

    کاربر وارد می‌شود و آگهی می‌گذارد؛ owner_id خودکار پر می‌شود.

    POST /v1/listing
  • نشان‌کردن آگهی

    علاقه‌مندی‌ها فقط برای صاحبشان خوانده می‌شوند.

    POST /v1/favorite

داده‌ای که همان لحظه دارید

این ردیف‌ها با ساخت پروژه در جدول‌ها هستند. رکورد معمولی‌اند و هر وقت خواستید از پنل ویرایش یا پاکشان می‌کنید.

دسته‌بندی

۲ ردیف/v1/category
نامنشانی
موبایل و تبلتmobile
لوازم خانگیhome

شهر

۲ ردیف/v1/city
نامنشانیاستان
تهرانtehranتهران
شیرازshirazفارس

آگهی

۴ ردیف/v1/listing
عنوانقیمت (تومان)وضعیت کالاوضعیت آگهی
گوشی سامسونگ گلکسی A54 در حد نو۱۴٬۵۰۰٬۰۰۰کارکردهفعال
تبلت لنوو ۱۰ اینچی برای مطالعه۰کارکردهفعال
یخچال فریزر امرسان سفید۹٬۸۰۰٬۰۰۰کارکردهفعال

و ۱ ردیف دیگر

علاقه‌مندی

۱ ردیف/v1/favorite
یادداشت
برای مقایسه با مدل بعدی

جدول‌ها و دسترسی

هر جدول یک مسیر API دارد و از قبل مشخص است چه کسی می‌خواندش. فیلدهای هر جدول زیر همان جدول باز می‌شوند.

  • دسته‌بندی

    /v1/category

    عمومی: هر کسی می‌خواندش، حتی بدون ورود و با کلید عمومی داخل اپ.

    درخت دسته‌بندی — عمومی، برای منوی اپ

    ۳ فیلدو ۱ رابطه
    • nameناممتنضروریقابل جستجو
    • slugنشانیمتنضروری
    • parent_idدستهٔ والدمتن
    • رابطه با دسته‌بندیچند به یکparent_id
  • شهر

    /v1/city

    عمومی: هر کسی می‌خواندش، حتی بدون ورود و با کلید عمومی داخل اپ.

    شهرها — عمومی

    ۳ فیلد
    • nameناممتنضروریقابل جستجو
    • slugنشانیمتنضروری
    • provinceاستانمتن
  • آگهی

    /v1/listing

    عمومی: هر کسی می‌خواندش، حتی بدون ورود و با کلید عمومی داخل اپ.

    آگهی‌ها — عمومی، و عنوان و توضیحاتشان با جستجوی فارسی پیدا می‌شوند

    ۱۳ فیلدو ۳ رابطه
    • owner_idآگهی‌دهندهمتن
    • titleعنوانمتنضروریقابل جستجو
    • descriptionتوضیحاتمتنضروریقابل جستجو
    • priceقیمت (تومان)عدد
    • is_negotiableقیمت توافقیبله/خیر= false
    • photoتصویرفایل
    • category_idدسته‌بندیمتنضروری
    • city_idشهرمتن
    • conditionوضعیت کالاگزینه‌ای= "used"
    • statusوضعیت آگهیگزینه‌ای= "active"
    • contact_phoneتلفن تماستلفنضروریفقط کاربر واردشده
    • view_countبازدیدعدد= 0
    • moderation_noteیادداشت بررسیمتنپنهان
    • رابطه با دسته‌بندیچند به یکcategory_id
    • رابطه با شهرچند به یکcity_id
    • رابطه با کاربرچند به یکowner_id
  • علاقه‌مندی

    /v1/favorite

    فقط صاحب ردیف: هر کاربر فقط ردیف‌های خودش را می‌بیند. مالکیت از روی user_id

    آگهی‌های نشان‌شده — فقط برای خود کاربر

    ۳ فیلدو ۱ رابطه
    • user_idکاربرمتن
    • listing_idآگهیمتنضروری
    • noteیادداشتمتن
    • رابطه با آگهیچند به یکlisting_id

قوانین آماده

منطقی که همراه قالب نصب می‌شود و از لحظهٔ ساخت فعال است، بدون اینکه یک خط کد بنویسید.

  • قیمت توافقی نباید عدد داشته باشد

    اعتبارسنجیروی آگهی

    پیامی که کاربر می‌گیرد: «آگهی توافقی نباید قیمت ثابت داشته باشد — یکی از این دو را انتخاب کنید»

  • شمارش علاقه‌مندی روی آگهی

    تریگرروی علاقه‌مندی

اولین درخواست

نمونه‌کدی که فقط نشانی پروژه و کلید شما را کم دارد. جای خالی‌ها را بعد از ساخت پروژه، خود پنل پر می‌کند.

جستجوی فارسی در آگهی‌ها

آگهی‌ها عمومی‌اند و عنوان و توضیحاتشان با «?search=» پیدا می‌شوند — «كتاب» آگهی «کتاب» را هم می‌آورد.

npm install @fikaro/client
import { createClient } from "@fikaro/client";

const client = createClient({
  project: "{{slug}}",
  key: "{{publishable_key}}",
});

// جستجوی فارسی — نیم‌فاصله و کاف عربی خودکار یکسان‌سازی می‌شوند
const { data: results } = await client.from("listing").list({
  search: "یخچال",
  filter: { status: "active" },
  include: "category,city",
});

// تلفن تماس فقط بعد از ورود کاربر برمی‌گردد
await client.auth.login("seller@example.com", "«رمزی که هنگام ساخت پروژه دیدید»");
const { data: withPhone } = await client.from("listing").list({ search: "یخچال" });

کلید عمومی ویترین و جستجو را می‌دهد، ولی تلفن تماس را نه: آن فیلد فقط برای کاربر واردشده برمی‌گردد تا شماره‌ها به‌سادگی برداشت انبوه نشوند. علاقه‌مندی‌ها «فقط مال خود کاربر» است. جستجو ی/ي، ک/ك، نیم‌فاصله، اعراب و ارقام فارسی را خودکار یکسان می‌کند، پس لازم نیست کاربر درست تایپ کند.

قالب‌های دیگر

از همین قالب شروع کنید؛ بک‌اندش با من.

ماه اول رایگانبا پلناسپرسو

اعتبار هدیهٔ ثبت‌نام هزینه‌اش را می‌دهد؛ لازم نیست حتی یک تومان پرداخت کنید.

شروع رایگان با این قالب