نوشتن api برای اتصال سایت به ترب

شرح پروژه

سلام برای اتصال سایتم به ترب، از طرف سایت ترب یک دستورالعملی داده شده برای نوشتن یک api که خیلی واضح و با جزئیات مشخص شده است.

----

دستورالعمل هم به شرح پائینه:

روش درخواست به api:¶
متد درخواست: POST
آدرس درخواست: https://domain.com/{anything}/products
قسمت {anything} بدین معناست که فقط نیاز است آخرین دایرکتوری برابر products باشد و قبل از آن به انتخاب شما هر مسیر و مقداری می تواند داشته باشد.
ورودی:
شناسه محصول: page_unique
لینک محصول: page_url
شماره صفحه: page
پارامتر page در صورتی که ارسال نشود برابر ۱ است و برای صفحات بعدی ارسال خواهد شد.
خروجی:
در این api دو نوع خروجی تصور شده است.

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

توضیح خروجی api:¶
count: تعداد کل محصولات
max_pages: تعداد کل صفحات با در نظر گرفتن ۱۰۰ محصول در هر صفحه
title: عنوان محصول
subtitle: زیرعنوان (معمولا نام انگلیسی محصول) (اختیاری)
page_unique: شناسه اختصاصی و غیرتکراری محصول
current_price: قیمت فروش
old_price: قیمت قبل از تخفیف (اختیاری)
availability: وضعیت موجودی. برای بیان موجود بودن محصول از مقدار instock استفاده فرمایید.
category_name: دسته بندی (اختیاری)
image_link: آدرس تصویر اصلی محصول
image_links: یک لیست از آدرس تصاویر محصول (شامل تصویر اصلی)
page_url: آدرس محصول
short_desc: توضیح مختصر در مورد محصول (اختیاری)
spec: آرایه ای از عناوین و مقادیر ویژگی ها (اختیاری). در این آرایه هر ویژگی به صورت نام و مقدار گنجاده می شود. هم نام و هم مقدار می توانند انگلیسی یا فارسی باشند.
registry: رجیستری. اگر محصول رجیستر شده است از مقدار رجیستر شده و در غیر اینصورت از مقدار رجیستر نشده استفاده فرمایید (اختیاری).
guarantee: گارانتی محصول (اختیاری)
ملاحظات:¶
محصولات در صفحه‌ی موردنظر، به ترتیب جدید به قدیم مرتب شوند. یعنی محصولات جدیدا اضافه شده و جدیدا ویرایش شده در اولویت قرار داشته باشند.
مواردی که اختیاری هستند، نیازی به پیاده سازی ندارند ولی در صورت عدم پیاده سازی ممکن است تایید و دسته بندی آن ها با تاخیر روبرو شود.
در هر صفحه از خروجی انتظار می رود، ۱۰۰ محصول نمایش داده شوند.
رجیستری فقط برای محصولات دسته‌ی موبایل کاربرد دارد.
دقت فرمایید از همین روش برای تک محصول نیز باید استفاده شود، یعنی در صورتی که لینک یا شناسه‌ی محصول برای api ارسال گردد، اطلاعات مربوطه در لیستی که حاوی یک محصول است نمایش داده شود.
پارامترها به صورت form-data ارسال خواهند شد.
ممکن است به آخر لینک ها پارامترهایی مانند utm اضافه شود، در نتیجه هنگام درخواست مشخصات محصول از طریق لینک محصول این پارامترها نباید باعث خطا و عدم ارسال پاسخ شوند. برای مثال، لینک روبرو باید مشابه لینک اصلی محصول تعبیر شود: https://domain.com/product/example?utm_medium=PPC&utm_source=Torob
لطفا برای title و subtitle محدودیت ۵۰۰ کاراکتری و برای image_link محدودیت ۱۰۰۰ کاراکتری در نظر بگیرید.

مهارت ها و تخصص های مورد نیاز

درباره کارفرما

alijaha

عضویت یک ماه پیش

1 پروژه ثبت شده ،

0 پروژه در حال انجام ،

0 پروژه آماده دریافت پیشنهاد ،

نرخ پذیرش پیشنهاد 0%