سه راه انتشار
- فهرست زنده: فروشگاه یک نشانی JSON صفحه‌بندی‌شده منتشر می‌کند. اگر قیمت و موجودی در روز زیاد عوض می‌شود، همین راه را انتخاب کنید.
- پروندهٔ ثابت: یک فایل JSON، CSV، TSV یا XML با لینک پایدار که حداقل روزی یک‌بار تازه شود. فشردهٔ ZIP یا GZIP هم پذیرفته است؛ لینک فایل فشرده را در پنل ثبت کنید.
- برداشت از صفحه: گردآورندهٔ راتک لند حدود نیمه‌شب صفحات کالا را می‌خواند. نقشهٔ سایت کامل و به‌روز لازم است.
اگر فروشگاه ووکامرس یا فروشگاه‌ساز دیگری دارید، همین قرارداد را روی دامنهٔ خودتان پیاده کنید.راتک لند بستهٔ آمادهٔ وردپرس توزیع نمی‌کند.
نشانی را در پنل پذیرنده، بخش «نمایه کالا»، ثبت و با دکمهٔ «بررسی اتصال» امتحان کنید. اگر کالا خدمت است نه کالای فیزیکی، فیلدهایی که معنا ندارند را خالی بگذارید.
قرارداد فهرست زنده
نمونهٔ مسیر روی فروشگاه شما:
GET https://shop.example.com/ratek/item-index?offset=0&limit=50
X-Ratek-Index-Key: {secret}offsetاز صفر شروع می‌شود وlimitاندازهٔ هر صفحه است. هر دو اختیاری‌اند؛ پیش‌فرض منطقی ۵۰ قلم است.- اگر فهرست عمومی نیست، نام و مقدار هدر را در پنل ثبت کنید تا گردآورنده همان هدر را بفرستد.
- برای کالاهای پربازدید، خواندن تک‌قلم را هم باز کنید:
GET /ratek/item-index/items/{merchantSku}وGET /ratek/item-index/items/by-slug/{slug}
نمونهٔ پاسخ: item-index.sample.json
فیلدها
| فیلد | الزام | معنی |
|---|---|---|
| merchantSku | بله | شناسه یا SKU یکتا در فروشگاه شما |
| name | بله | نام کامل کالا، شامل برند، مدل و مشخصهٔ اصلی |
| alternateName | خیر | نام لاتین یا زیرعنوان |
| slug | خیر | شناسهٔ پایدار در نشانی صفحه؛ برای خواندن تک‌کالا |
| productUrl | بله | نشانی صفحهٔ کالا؛ آن را عوض نکنید |
| gallery | بله | آرایهٔ نشانی تصویر. عضو اول، تصویر اصلی است |
| stockStatus | بله | AVAILABLE یا UNAVAILABLE |
| listPriceIrr | بله | قیمت پیش از تخفیف، به ریال |
| payablePriceIrr | بله | قیمت قابل پرداخت، به ریال |
| categoryPath | بله | مسیر دسته تا نوع کالا، مثلاً «لوازم خانگی > یخچال و فریزر» |
| brandName | خیر | نام برند |
| attributes | خیر | شیء ویژگی-مقدار؛ برای تطبیق بهتر در جستجو |
| tradeCode | خیر | بارکد یا شناسهٔ تجاری کالا |
| colorName | خیر | رنگ |
| sizeLabel | خیر | سایز |
| shippingIrr | خیر | هزینهٔ ارسال به ریال |
| dispatchDays | خیر | زمان آماده‌سازی ارسال، به روز |
قیمت‌ها همیشه به ریال هستند. attributes را این‌طور بسازید:
{
"برند": "دوو",
"مدل": "D2LR-0020",
"ظرفیت": "۲۰ فوت",
"یخساز": "دارد"
}برداشت از صفحه
- گردآورنده را مسدود نکنید. نشانی‌های اعلام‌شده را در دیوارهٔ آتش و سرویس امنیتی فروشگاه مجاز کنید. این نشانی‌ها برای فهرست زنده و برداشت صفحه هر دو لازم‌اند.
- نقشهٔ سایت روزانه همهٔ لینک کالاها را داشته باشد.
- نام، دسته، قیمت، موجودی، تصویر و توضیح باید در HTML اولیه یا در متاتگ باشد، نه فقط بعد از اجرای جاوااسکریپت.
نشانی گردآورنده بعد از فعال‌سازی در پنل پذیرنده، بخش نمایه کالا، نوشته می‌شود. فروشگاه باید از اینترنت عمومی با HTTPS باز باشد و پشت شبکهٔ خصوصی یا محدودیت جغرافیایی نماند.
نام‌گذاری و پایداری لینک
عنوان باید یکتا باشد و برند، مدل و مشخصهٔ تصمیم‌ساز را داشته باشد.
مناسب: «یخچال فریزر دوو، مدل D2LR-0020، ظرفیت ۲۰ فوت، نقره‌ای»
ضعیف: «D2LR نقره‌ای»
لینک کالا را ثابت نگه دارید. اگر نام، تصویر، ویژگی، لینک یا قالب سایت عوض شد، از تیکت پشتیبانی پنل پذیرنده خبر دهید تا قلم از نتایج حذف نشود.
چک‌لیست آماده‌سازی
- یکی از سه راه بالا انتخاب شده و نشانی در پنل ذخیره شده است.
- بررسی اتصال در پنل بدون خطا تمام شده، یا پروندهٔ غیر JSON طبق همین جدول ساخته شده است.
- نشانی‌های گردآورنده، وقتی اعلام شدند، در فایروال مجاز شده‌اند.
- نقشهٔ سایت کالاها روزانه تازه می‌شود.
- اطلاعات اصلی کالا بدون جاوااسکریپت در صفحه هست.
- نام کالاها کامل و شامل برند و مدل است.
- تغییر لینک یا قالب سایت به پشتیبانی اعلام می‌شود.
اتصال پرداخت جدا از نمایهٔ کالاست. راهنمای درگاه پرداخت اعتباری