اتصال در پاتریس یار و تست
پس از پیادهسازی endpointها، سایت را در پاتریس یار به عنوان یک «اتصال» ثبت میکنید و آن را آزمایش میکنید. این صفحه مراحل ثبت و فهرست بررسی پیش از شروع کار واقعی را میگوید.
پیشنیازها
- نسخهای از پاتریس یار که اتصال «سایت اختصاصی (REST API)» را دارد، روی رایانهی فروشگاه نصب شده و به حساب پاتریس وصل است.
- کلید API از پشتیبانی پایاوا گرفته شده و در تنظیمات سایت ذخیره شده است.
- حداقل
GET /patris-yar/ping،GET /patris-yar/orders،POST /patris-yar/orders/delivered،POST /patris-yar/orders/:id/ackوPOST /patris-yar/productsروی سایت کار میکنند.
سایت را چطور در پاتریس یار ثبت کنم؟
- در پاتریس یار به بخش «فروشگاه اینترنتی» بروید و «+ افزودن اتصال» را بزنید.
- در «نوع اتصال» گزینهی «سایت اختصاصی (REST API)» را انتخاب کنید.
- در «آدرس API» آدرس سایت را وارد کنید، مثلاً
https://shop.example.com. پاتریس یار مسیرهایی مثل/patris-yar/pingرا به انتهای همین آدرس اضافه میکند. - در «کلید اتصال» همان کلید
ppk_سایت را وارد کنید. - روش دریافت سفارش را انتخاب کنید:
- «دریافت مستقیم از همین اتصال» برای روش pull.
- «دریافت از طریق سرور پاتریس» برای روش cloud. جزئیات در ارسال سفارش به سرور پاتریس.
- «از این اتصال سفارش دریافت نشود» اگر فقط قیمت و موجودی لازم است.
- اگر قیمت و موجودی باید به سایت برود، «بهروزرسانی قیمت و موجودی کالاها در این اتصال» را روشن کنید و «تعداد در هر ارسال» را تنظیم کنید.
- «تست اتصال» را بزنید.
برای مای پاتریس، همین مراحل را در بخش «مای پاتریس» انجام دهید. جزئیات در مای پاتریس روی سایت اختصاصی.
تست اتصال چه چیزهایی را بررسی میکند؟
- کلید را با سرور پاتریس: معتبر بودن، اشتراک و امکانات حساب.
GET /patris-yar/pingروی سایت: در دسترس بودن سایت و برابری کلید.- یکی بودن
order_modeسایت با روش انتخابشده در پاتریس یار. اگر یکی نباشند، هشدار میدهد.
پیش از شروع کار واقعی چه چیزهایی را بررسی کنم؟
- یک سفارش آزمایشی با کالایی که کد پاتریس دارد ثبت کنید و ببینید در پاتریس با کد کالای درست ثبت میشود.
- یک سفارش آزمایشی با کالای بدون کد پاتریس ثبت کنید. قلم آن باید با یادداشت «کد پاتریس (PIP) این محصول در سایت ثبت نشده» برسد. سپس کد را در سایت ثبت کنید و ببینید در دور بعد کامل میشود.
- مبلغهای سفارش در پاتریس را با سایت مقایسه کنید (ضریب تومان و ریال).
- بررسی کنید سفارش دریافتشده در دور بعد دوباره در
GET /patris-yar/ordersنمیآید. - سفارش را در پاتریس تأیید کنید و ببینید وضعیت
confirmedبهPOST /patris-yar/orders/:id/ackمیرسد. - قیمت یک کالا را در پاتریس تغییر دهید و ببینید قیمت محصول متصل در سایت با ضریب درست تغییر میکند.
- موجودی یک کالا را در پاتریس تغییر دهید و ببینید موجودی سایت از انبار درست خوانده میشود.
نکتهها
هر سایت، یک کلید و یک رایانه
در روش «دریافت از طریق سرور پاتریس»، اگر دو پاتریس یار با یک کلید سفارش بگیرند، سفارشها بین آنها تقسیم میشوند. برای هر کلید فقط یک رایانهی فروشگاه را روی دریافت سفارش بگذارید.
- اگر «تست اتصال» خطای
404داد، «آدرس API» را بررسی کنید و مسیر/patris-yar/pingرا با curl از همان رایانهی فروشگاه آزمایش کنید. - معنی خطاهایی که پاتریس یار نشان میدهد در قالب خطاها آمده است.