پرش به مطلب اصلی

اتصال در پاتریس یار و تست

پس از پیاده‌سازی endpointها، سایت را در پاتریس یار به عنوان یک «اتصال» ثبت می‌کنید و آن را آزمایش می‌کنید. این صفحه مراحل ثبت و فهرست بررسی پیش از شروع کار واقعی را می‌گوید.

پیش‌نیازها​

سایت را چطور در پاتریس یار ثبت کنم؟​

  1. در پاتریس یار به بخش «فروشگاه اینترنتی» بروید و «+ افزودن اتصال» را بزنید.
  2. در «نوع اتصال» گزینه‌ی «سایت اختصاصی (REST API)» را انتخاب کنید.
  3. در «آدرس API» آدرس سایت را وارد کنید، مثلاً https://shop.example.com. پاتریس یار مسیرهایی مثل /patris-yar/ping را به انتهای همین آدرس اضافه می‌کند.
  4. در «کلید اتصال» همان کلید ppk_ سایت را وارد کنید.
  5. روش دریافت سفارش را انتخاب کنید:
    • «دریافت مستقیم از همین اتصال» برای روش pull.
    • «دریافت از طریق سرور پاتریس» برای روش cloud. جزئیات در ارسال سفارش به سرور پاتریس.
    • «از این اتصال سفارش دریافت نشود» اگر فقط قیمت و موجودی لازم است.
  6. اگر قیمت و موجودی باید به سایت برود، «به‌روزرسانی قیمت و موجودی کالاها در این اتصال» را روشن کنید و «تعداد در هر ارسال» را تنظیم کنید.
  7. «تست اتصال» را بزنید.

برای مای پاتریس، همین مراحل را در بخش «مای پاتریس» انجام دهید. جزئیات در مای پاتریس روی سایت اختصاصی.

تست اتصال چه چیزهایی را بررسی می‌کند؟​

  • کلید را با سرور پاتریس: معتبر بودن، اشتراک و امکانات حساب.
  • GET /patris-yar/ping روی سایت: در دسترس بودن سایت و برابری کلید.
  • یکی بودن order_mode سایت با روش انتخاب‌شده در پاتریس یار. اگر یکی نباشند، هشدار می‌دهد.

پیش از شروع کار واقعی چه چیزهایی را بررسی کنم؟​

  1. یک سفارش آزمایشی با کالایی که کد پاتریس دارد ثبت کنید و ببینید در پاتریس با کد کالای درست ثبت می‌شود.
  2. یک سفارش آزمایشی با کالای بدون کد پاتریس ثبت کنید. قلم آن باید با یادداشت «کد پاتریس (PIP) این محصول در سایت ثبت نشده» برسد. سپس کد را در سایت ثبت کنید و ببینید در دور بعد کامل می‌شود.
  3. مبلغ‌های سفارش در پاتریس را با سایت مقایسه کنید (ضریب تومان و ریال).
  4. بررسی کنید سفارش دریافت‌شده در دور بعد دوباره در GET /patris-yar/orders نمی‌آید.
  5. سفارش را در پاتریس تأیید کنید و ببینید وضعیت confirmed به POST /patris-yar/orders/:id/ack می‌رسد.
  6. قیمت یک کالا را در پاتریس تغییر دهید و ببینید قیمت محصول متصل در سایت با ضریب درست تغییر می‌کند.
  7. موجودی یک کالا را در پاتریس تغییر دهید و ببینید موجودی سایت از انبار درست خوانده می‌شود.

نکته‌ها​

هر سایت، یک کلید و یک رایانه

در روش «دریافت از طریق سرور پاتریس»، اگر دو پاتریس یار با یک کلید سفارش بگیرند، سفارش‌ها بین آن‌ها تقسیم می‌شوند. برای هر کلید فقط یک رایانه‌ی فروشگاه را روی دریافت سفارش بگذارید.

  • اگر «تست اتصال» خطای 404 داد، «آدرس API» را بررسی کنید و مسیر /patris-yar/ping را با curl از همان رایانه‌ی فروشگاه آزمایش کنید.
  • معنی خطاهایی که پاتریس یار نشان می‌دهد در قالب خطاها آمده است.