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

سلام برای اتصال سایتم به ترب، از طرف سایت ترب یک دستورالعملی داده شده برای نوشتن یک api که خیلی واضح و با جزئیات مشخص شده است. ---- دستورالعمل هم به شرح پائینه: روش درخواست به api:¶متد درخواست: POSTآدرس درخواست: https://domain.com/{anything}/productsقسمت {anything} بدین معناست که فقط نیاز است آخرین دایرکتوری برابر products باشد و قبل از آن به انتخاب شما هر مسیر و مقداری می تواند داشته باشد.ورودی:شناسه محصول: page\_uniqueلینک محصول: page\_urlشماره صفحه: pageپارامتر page در صورتی که ارسال نشود برابر 1 است و برای صفحات بعدی ارسال خواهد شد.خروجی:در این api دو نوع خروجی تصور شده است. اگر هیچ پارامتری ارسال نشود یا فقط پارامتر page ارسال شود، خروجی برابر لیست محصولات خواهد بود که قالب آن در ادامه توضیح داده شده است.اگر یکی از دو ورودی page\_unique یا page\_url ارسال شود، محصول متناظر با همان شناسه یا لینک محصول در خروجی نمایش داده خواهد شد. توضیح خروجی api:¶count: تعداد کل محصولاتmax\_pages: تعداد کل صفحات با در نظر گرفتن 100 محصول در هر صفحهtitle: عنوان محصولsubtitle: زیرعنوان (معمولا نام انگلیسی محصول) (اختیاری)page\_unique: شناسه اختصاصی و غیرتکراری محصولcurrent\_price: قیمت فروشold\_price: قیمت قبل از تخفیف (اختیاری)availability: وضعیت موجودی. برای بیان موجود بودن محصول از مقدار instock استفاده فرمایید.category\_name: دسته بندی (اختیاری)image\_link: آدرس تصویر اصلی محصولimage\_links: یک لیست از آدرس تصاویر محصول (شامل تصویر اصلی)page\_url: آدرس محصولshort\_desc: توضیح مختصر در مورد محصول (اختیاری)spec: آرایه ای از عناوین و مقادیر ویژگی ها (اختیاری). در این آرایه هر ویژگی به صورت نام و مقدار گنجاده می شود. هم نام و هم مقدار می توانند انگلیسی یا فارسی باشند.registry: رجیستری. اگر محصول رجیستر شده است از مقدار رجیستر شده و در غیر اینصورت از مقدار رجیستر نشده استفاده فرمایید (اختیاری).guarantee: گارانتی محصول (اختیاری)ملاحظات:¶محصولات در صفحه‌ی موردنظر، به ترتیب جدید به قدیم مرتب شوند. یعنی محصولات جدیدا اضافه شده و جدیدا ویرایش شده در اولویت قرار داشته باشند.مواردی که اختیاری هستند، نیازی به پیاده سازی ندارند ولی در صورت عدم پیاده سازی ممکن است تایید و دسته بندی آن ها با تاخیر روبرو شود.در هر صفحه از خروجی انتظار می رود، 100 محصول نمایش داده شوند.رجیستری فقط برای محصولات دسته‌ی موبایل کاربرد دارد.دقت فرمایید از همین روش برای تک محصول نیز باید استفاده شود، یعنی در صورتی که لینک یا شناسه‌ی محصول برای api ارسال گردد، اطلاعات مربوطه در لیستی که حاوی یک محصول است نمایش داده شود.پارامترها به صورت form-data ارسال خواهند شد.ممکن است به آخر لینک ها پارامترهایی مانند utm اضافه شود، در نتیجه هنگام درخواست مشخصات محصول از طریق لینک محصول این پارامترها نباید باعث خطا و عدم ارسال پاسخ شوند. برای مثال، لینک روبرو باید مشابه لینک اصلی محصول تعبیر شود: https://domain.com/product/example?utm\_medium=PPC&utm\_source=Torobلطفا برای title و subtitle محدودیت 500 کاراکتری و برای image\_link محدودیت 1000 کاراکتری در نظر بگیرید.