محصولات

---

برای مدیریت و استعلام محصولات خود اطلاعات زیر را مطالعه کنید

ساخت محصول

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

#	توضیحات	نوع	عنوان فیلد
	شناسه فروشگاه	string	* shop_id
	نام محصول	string	title *
	شناسه گروه محصول	string	category_id *
	وزن	int	weight *
	قیمت	int	price *
	توضیحات	string	description *

https://api.tapin.ir/api/v2/public/product/create/POST

نمونه جیسون جهت ارسال

{
    "shop_id": "f429ee63...",
    "title": "TEST_PRODUCT",
    "price": 100,
    "weight": 100,
    "description": null,
    "category_id":"3d65e6eb-ca0d-47b3-9934-6295a355872f"
}

نمونه جیسون خروجی

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "product_id": 3670,
        "title": "TEST_PRODUCT",
        "category_id": "3d65e6eb-ca0d-47b3-9934-6295a355872f",
        "weight": 100,
        "price": 100,
        "created_at": "1399-02-26 23:26"
    }
}

.

ویرایش محصول

به منظور ویرایش محصولات خود میبایست به وب سرویس رو به رو با متد درج شده آن درخواست ارسال نمایید و باتوجه به راهنمای پارامترها در جدول زیر جیسون ارسالی خود رامقداردهی کنید.

#	توضیحات	نوع	عنوان فیلد
	شناسه فروشگاه	string	* shop_id
	شناسه محصول	int	product_id *
	نام محصول	string	title *
	شناسه گروه محصول	string	category_id *
	وزن	int	weight *
	قیمت	int	price *
	توضیحات	string	description *

https://api.tapin.ir/api/v2/public/product/update/POST

نمونه جیسون جهت ارسال

{
    "shop_id": "f429ee...",
    "product_id": 3670,
    "title": "TEST_PRODUCT 2",
    "price": 1000,
    "weight": 1000,
    "description": null,
    "category_id":"3d65e6eb-ca0d-47b3-9934-6295a355872f"
}

نمونه جیسون خروجی

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "product_id": 3670,
        "title": "TEST_PRODUCT 2",
        "category_id": "3d65e6eb-ca0d-47b3-9934-6295a355872f",
        "weight": 1000,
        "price": 1000,
        "created_at": "1399-02-26 23:26"
    }
}

حذف محصول

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

#	توضیحات	نوع	عنوان فیلد
	شناسه فروشگاه	string	* shop_id
	شناسه محصول	int	product_id *

https://api.tapin.ir/api/v2/public/product/delete/POST

نمونه جیسون جهت ارسال

{
    "shop_id": "f429ee63-bcb4-4783-bee2-676e51ba907f",
    "product_id": 3669
}

نمونه جیسون خروجی

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "product_id": null,
        "title": "",
        "category_id": "",
        "weight": null,
        "price": null,
        "created_at": null
    }
}

لیست محصولات

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

#	توضیحات	نوع	عنوان فیلد
	تعداد آیتم های جهت نمایش در صفحه	int	count *
	شماره صفحه	int	page *
	شناسه فروشگاه	str	* shop_id
	شناسه یکتای محصول	int	product_id
	نام	string	title
	شناسه گروه محصول	string	category_id
	وزن	int	weight
	قیمت	int	price
	تاریخ ایجاد	string	created_at

https://api.tapin.ir/api/v2/public/product/list/POST

نمونه جیسون جهت ارسال

{
    "count":10,
    "page":1,
    "shop_id": "fc45949a-921d-4b4f-1ade-ab5180f7dcve"
}

نکته

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

فیلد تاریخ ایجاد باید بصورت یکی از فرمت های زیر باشد:

"created_at": "1398-11-12 12:30"

"created_at": "1398-11-12"

نمونه جیسون خروجی

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "product_id": 1924,
                "title": "product_title",
                "category_id": "3d65e6eb-ca0d-47b3-9934-6295a355872f",
                "weight": 500,
                "price": 800000,
                "created_at": "1398-04-19 17:07"
            }
        ],
        "count": 1,
        "page": 1,
        "total_count": 3
    }
}

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

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

#	توضیحات	نوع	عنوان فیلد
	تعداد آیتم های جهت نمایش در صفحه	int	count *
	شماره صفحه	int	page *

---

#	توضیحات	نوع	عنوان فیلد
	شناسه گروه	str	category_id *
	نام گروه	str	title *
	شناسه گروه پدر	str	parent_category_id*
	شماره صفحه	int	count *
	تعداد آیتم ها در صفحه	int	page *
	تعداد کل آیتم ها	int	total_count *

https://api.tapin.ir/api/v2/public/product/category/list/POST

نمونه جیسون جهت ارسال

{
    "count":10,
    "page":1
}

نمونه جیسون خروجی

{
    "returns": {
        "status": 200,
        "message": "عملیات با موفقیت انجام شد."
    },
    "entries": {
        "list": [
            {
                "category_id": "3d65e6eb-ca0d-47b3-9934-6295a355872f",
                "title": "مجلات",
                "parent_category_id": null
            },
            {
                "category_id": "3421e007-1b61-4130-a1ed-7e52d8f6260f",
                "title": "کتاب",
                "parent_category_id": null
            },
            {
                "category_id": "e1a522ce-1fae-435e-ab6e-7a67799ce359",
                "title": "بدون دسته بندی",
                "parent_category_id": null
            }
        ],
        "count": 3,
        "page": 1,
        "total_count": 3
    }
}