بکاند آماده آگهیهای نیازمندی
آگهی و دستهبندی عمومی با جستجوی فارسی، آگهیهای من و علاقهمندیها خصوصی.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.
با دکمهٔ زیر، پروژه روی پلن اسپرسو شروع میشود. پلن پیشنهادی این قالب کاپوچینو است، با ۱۵ روز رایگان؛ در قدم پلن با یک کلیک انتخابش میکنید.
مناسب برای
- نیازمندیهای کالای دست دوم
- اپ آگهی محلی با جستجو
- اجاره و خرید و فروش
همان لحظهٔ ساخت، اینها در جدول هستند
/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قیمت توافقیبله/خیر= falsephotoتصویرفایلcategory_idدستهبندیمتنضروریcity_idشهرمتنconditionوضعیت کالاگزینهای= "used"statusوضعیت آگهیگزینهای= "active"contact_phoneتلفن تماستلفنضروریفقط کاربر واردشدهview_countبازدیدعدد= 0moderation_noteیادداشت بررسیمتنپنهان
- رابطه با دستهبندیچند به یک
category_id - رابطه با شهرچند به یک
city_id - رابطه با کاربرچند به یک
owner_id
علاقهمندی
/v1/favoriteفقط صاحب ردیف: هر کاربر فقط ردیفهای خودش را میبیند. مالکیت از روی
user_idآگهیهای نشانشده — فقط برای خود کاربر
۳ فیلدو ۱ رابطه
user_idکاربرمتنlisting_idآگهیمتنضروریnoteیادداشتمتن
- رابطه با آگهیچند به یک
listing_id
قوانین آماده
منطقی که همراه قالب نصب میشود و از لحظهٔ ساخت فعال است، بدون اینکه یک خط کد بنویسید.
قیمت توافقی نباید عدد داشته باشد
اعتبارسنجیروی آگهیپیامی که کاربر میگیرد: «آگهی توافقی نباید قیمت ثابت داشته باشد — یکی از این دو را انتخاب کنید»
شمارش علاقهمندی روی آگهی
تریگرروی علاقهمندی
اولین درخواست
نمونهکدی که فقط نشانی پروژه و کلید شما را کم دارد. جای خالیها را بعد از ساخت پروژه، خود پنل پر میکند.
جستجوی فارسی در آگهیها
آگهیها عمومیاند و عنوان و توضیحاتشان با «?search=» پیدا میشوند — «كتاب» آگهی «کتاب» را هم میآورد.
npm install @fikaro/clientimport { 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: "یخچال" });
کلید عمومی ویترین و جستجو را میدهد، ولی تلفن تماس را نه: آن فیلد فقط برای کاربر واردشده برمیگردد تا شمارهها بهسادگی برداشت انبوه نشوند. علاقهمندیها «فقط مال خود کاربر» است. جستجو ی/ي، ک/ك، نیمفاصله، اعراب و ارقام فارسی را خودکار یکسان میکند، پس لازم نیست کاربر درست تایپ کند.
از همین قالب شروع کنید؛ بکاندش با من.
ماه اول رایگانبا پلناسپرسو
اعتبار هدیهٔ ثبتنام هزینهاش را میدهد؛ لازم نیست حتی یک تومان پرداخت کنید.