رابط باز (C9)

توسعه‌دهندگان نکسوپین

نرم‌افزار دیگر شما (حسابداری، ناوگان، فروشگاه) می‌تواند رکورد سرویس استاندارد (C2) را در کارگاه خودش ثبت کند و هنگام تحویل هر سرویس، وب‌هوک امضاشده بگیرد. احراز هویت با کلید هر کارگاه در سربرگ X-Api-Key است؛ فقط دادهٔ همان کارگاه برمی‌گردد.

  1. ۱. صدور کلید از پنل کارگاه

    از بخش «یکپارچه‌سازی» پنل، یک کلید با دامنهٔ خواندن رکورد سرویس یا ثبت رکورد سرویس بسازید. مقدار واقعی کلید فقط یک‌بار نشان داده می‌شود؛ گم شد، لغو و کلید تازه بسازید.

  2. ۲. ثبت رکورد سرویس

    POST /api/v1/partner/service-records با بدنهٔ خدمت، پلاک، کیلومتر، منشأ و شناسهٔ یکتای اختیاری (ClientRequestId برای جلوگیری از ثبت تکراری). پاسخ، شناسهٔ رکورد و وضعیت ارسال وب‌هوک را برمی‌گرداند.

  3. ۳. وب‌هوک تکمیل سرویس خودرو

    نشانی https خود را در پنل ثبت کنید؛ هنگام تحویل هر سرویس، بدنهٔ JSON کم‌حجم (بدون نام و موبایل مشتری) با امضای X-Nexo-Signature (HMAC-SHA256 روی بدنهٔ خام) ارسال می‌شود. رویدادهای آینده هنوز «رزرو»‌اند و ارسال نمی‌شوند.

مدیریت کلید و وب‌هوک فقط برای مالک و مدیر کارگاه از داخل پنل است. سقف نرخ عمومی و سقف ۱۰ وب‌هوک فعال برای هر کارگاه اعمال می‌شود.