وایت‌لیست IP
آی‌پی سرورهای خود را مستقیم از پنل نجوا (تنظیمات > توسعه‌دهندگان > IPهای مجاز) برای دسترسی به API ثبت کنید.
برای استفاده از API، لازم است آی‌پی‌های سرور خود را وایت‌لیست کنید. این کار را خودتان و مستقیم از پنل نجوا انجام می‌دهید و نیازی به ثبت تیکت نیست.
پیش از شروع، فهرست آی‌پی‌های عمومی (Public IP) سرورهایی را که از آن‌ها درخواست ارسال می‌کنید آماده داشته باشید.
افزودن آی‌پی در پنل
از منوی کناری، «تنظیمات» را باز کنید و «توسعه‌دهندگان» را انتخاب کنید (همان صفحه‌ای که کلید API را در آن می‌سازید). سپس تب «IPهای مجاز» را باز کنید.
روی دکمهٔ «+ افزودن IP مجاز» کلیک کنید و آی‌پی سرور خود را وارد کنید. اگر بخواهید، برای هر آی‌پی یک توضیح هم بنویسید (مثلاً نام یا کاربرد سرور). اگر از چند سرور درخواست می‌فرستید، آی‌پی هر کدام را اضافه کنید.
آی‌پی‌های ثبت‌شده در همین جدول، با ستون‌های آدرس IP / رنج، توضیحات و تاریخ ایجاد،
دیده می‌شوند و با منوی سه‌نقطه (⋮) کنار هر ردیف می‌توانید آن را مدیریت کنید. هر آی‌پی تکی در
فهرست به شکل 203.0.113.10/32 نمایش داده می‌شود.
نکته‌های مهم
تا وقتی آی‌پی سرور شما در فهرست IPهای مجاز نباشد، درخواست‌ها رد می‌شوند و پاسخ زیر را می‌گیرید:
{ "return": { "status": 416, "message": "IP سرویس مبدا با تنظیمات مطابقت ندارد" }, "entries": []}هر آی‌پی جدید را پیش از استفاده به فهرست اضافه کنید — مثلاً وقتی سرور تازه‌ای بالا می‌آورید، مقیاس افقی می‌دهید یا ارائه‌دهندهٔ ابری‌تان را عوض می‌کنید. این کار از پنل انجام می‌شود، پس آن را در برنامهٔ تغییرات زیرساخت خود هم بگنجانید.
کدام سرویس‌ها بررسی می‌شوند
بررسی وایت‌لیست روی سرویس‌های تراکنشی (مسیرهای /v1/{apiKey}/...) انجام می‌شود؛ یعنی همان
سرویس‌هایی که کلید API را در مسیر URL می‌گیرند.
آی‌پی دیده‌شده توسط سرویس، آی‌پی مبدأ درخواست است. اگر پشت NAT، پروکسی یا Load Balancer هستید، باید آی‌پی خروجی آن لایه را ثبت کنید، نه آی‌پی داخلی سرور خودتان.
پس از ثبت آی‌پی، برای ادامه به دریافت کلید API و احراز هویت مراجعه کنید.