افزودن محصول - روش api

معرفی بازار یوکا

بازار یوکا یک موتور جستجوی هوشمند محصولات است که به کاربران این امکان را می‌دهد تا کالاهای موردنظر خود را به‌سادگی جستجو کرده و با مقایسه قیمت‌ها، ویژگی‌ها و نظرات کاربران، بهترین تصمیم خرید را اتخاذ کنند. این پلتفرم با تمرکز بر شفافیت و امنیت خرید آنلاین، محیطی ایده‌آل برای خریداران و فروشگاه‌ها فراهم کرده است.

مستندات فنی API بازار یوکا

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

خروجی‌های API

API بازار یوکا دو خروجی اصلی را برمی‌گرداند:

1. total_pages_count: تعداد کل صفحات محصولات موجود.
2. products: آرایه‌ای از اطلاعات محصولات که شامل پارامترهای زیر است:
   • title: عنوان محصول
   • price: مبلغ قبل از تخفیف محصول (به تومان)
   • product_id: کد محصول (ثابت)
   • page_url: آدرس محصول
   • availability: موجودی محصول (1 = موجود، 0 = ناموجود)
   • off: تخفیف محصول (درصد بین 0 تا 99)
   • image: لینک تصاویر محصول (با کاما جدا شده‌اند)
   • category: دسته‌بندی‌های محصول (با کاما جدا شده‌اند)
   • guarantee: اطلاعات گارانتی

نحوه اتصال به بازار یوکا از طریق API

برای اتصال سایت خود به بازار یوکا و نمایش محصولات، مراحل زیر را دنبال کنید:

دریافت کل صفحات محصولات
ابتدا تعداد کل صفحات را از طریق API دریافت کنید:

GET /api/products?page=1

پاسخ شامل مقدار total_pages_count و محصولات صفحه اول خواهد بود.

دریافت اطلاعات محصولات
برای دریافت اطلاعات سایر صفحات، از پارامتر page استفاده کنید.

GET /api/products?page={page_number}

هر صفحه شامل آرایه‌ای از محصولات با اطلاعات کامل خواهد بود.

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

• عنوان محصول و قیمت را نشان دهید.
• تصویر محصول را با لینک مرتبط نمایش دهید.
• تخفیف‌ها را به‌صورت برجسته ارائه دهید.

مدیریت موجودی و تخفیف‌ها

• بررسی کنید که پارامتر availability برابر با 1 باشد تا فقط محصولات موجود را نمایش دهید.
• مقدار off را محاسبه و مبلغ نهایی محصول را نمایش دهید.

مثال پاسخ API :

{ "total_pages_count": 5,

"products": [ { "title": "کتاب مدیریت پروژه", "price": 150000, "product_id": "12345", "page_url": "https://ukweb.ir/product/12345", "availability": 1, "off": 20, "image": "https://ukweb.ir/images/book1.jpg,https://ukweb.ir/images/book2.jpg", "category": "مدیریت,کتاب", "guarantee": "ضمانت اصل بودن" }

] }

نتیجه‌گیری

بازار یوکا با ارائه API انعطاف‌پذیر، امکان اتصال آسان سایت‌ها را فراهم می‌کند. این قابلیت به شما کمک می‌کند تا محصولات متنوع یوکا را در سایت خود نمایش داده و تجربه بهتری برای کاربران فراهم کنید.