Skip to main content

سرویس محصول

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

پیش‌نیازها

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

آدرس پایه ارسال درخواست‌ها

https://core.affili.ir/services/products

API محصولات

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

نوع عملیاتنوع درخواستتوضیحاتuri
درون‌ریزیPOSTدرون‌ریزی محصولات؛ می‌توانید حداکثر ۱۰۰۰ محصول را در هر بار فراخوانی سرویس  درون‌ریزی کنید. /

درون‌ریزی محصولات

آدرس ارسال درخواست

POST https://core.affili.ir/services/products

قالب درخواست درون‌ریزی

{
  "products": [
  	object (Product),
    ...
  ]
}

پارامترها

ناماجباریتوضیحات
productsبلی

Array of Product Object

لیست محصولات

 

موجودیت‌ها

product

قالب JSON

{
  "pid": string,
  "name": string,
  "url": string,
  "price": double,
  "old_price": double,
  "in_stock": boolean,
  "images": [
    string,
    ...
  ],
  "categories": [
    object (Category)
  ],
  "last_update": dateTime
}

پارامترها

pid

String

شناسه یکتای محصول در وبسایت فروشگاه

name

String

نام محصول

url

String

آدرس صفحه محصول در وبسایت فروشگاه

price

Double

قیمت محصول

old_price

Double

قیمت قدیمی محصولی؛ در صورتی که محصول قیمت قدیمی ندارد مقدار این پارامتر برابر با null می‌شود.

in_stock

Boolean

وضعیت موجود بودن محصول؛ که می‌تواند یکی از مقادیر 0، 1، true یا false را داشته باشد.

images

Array

آرایه‌ای از آدرس عکس‌های محصول

categories

Array of Category Object

لیست دسته‌بندی‌های محصول

Category

قالب JSON

{
  "cid": string,
  "name": string,
  "url": string,
  "parent_cid": string,
  "is_primary": boolean
}

پارامترها

cid

String

شناسه یکتای دسته‌بندی در وبسایت فروشگاه

name

String

نام دسته‌بندی

url

String

آدرس صفحه دسته‌بندی در وبسایت فروشگاه

parent_cid

String

دسته والد؛ در صورتی که دسته‌بندی، دسته والد ندارد مقدار این پارامتر برابر با null می‌شود.

is_primary

Boolean

دسته‌بندی شاخص؛ در صورتی که این دسته‌بندی، دسته‌بندی شاخص محصول است مقدار این پارامتر برابر با ۱ یا true و در غیر این صورت برابر با ۰ یا false می‌شود.