X
منتشر شده: 2026-05-26 | به‌روزرسانی شده: 2026-05-26
خطای احراز هویت NiceNIC API v2: علل رایج و راه‌حل‌ها


اگر درخواست NiceNIC Reseller API v2 شما خطای احراز هویت برگرداند، مشکل معمولاً از اعتبارنامه API، سربرگ Authیاization، تنظیمات لیست سفید IP، دسترسی نمایندگی فروش، یا محیط سرور ارسال‌کننده درخواست ناشی می‌شود.

این راهنما رایج‌ترین علل را توضیح می‌دهد و به نمایندگان فروش، ارائه‌دهندگان میزبانی، توسعه‌دهندگان، آژانس‌ها، و کاربران WHMCS یک چک‌لیست عملی برای رفع مشکلات احراز هویت NiceNIC API v2 قبل از ارسال تیکت ارائه می‌کند.

خطای احراز هویت NiceNIC API v2 معمولاً به این معنی است که درخواست API قابل تأیید نیست. ابتدا بررسی کنید که آیا حساب شما دسترسی نمایندگی فروش دارد، آیا به جای رمز عبور ورود حساب NiceNIC خود از رمز عبور API استفاده می‌کنید، آیا سربرگ Authیاization به درستی قالب‌بندی شده است و آیا آدرس IP خروجی سرور شما در تنظیمات API لیست سفید شده است یا خیر.

درخواست‌های NiceNIC API v2 باید به نقطه پایان API با سربرگ‌های HTTP لازم، از جمله سربرگ Authیاization و تعیین Content-نوع به application/json ارسال شوند.



معنای معمول این خطای احراز هویت چیست
خطای احراز هویت API به این معنی است که NiceNIC نمی‌تواند درخواست API را به عنوان یک درخواست معتبر از حساب نمایندگی فروش مجاز تأیید کند. این همیشه به این معنی نیست که سرویس API قطع شده است. در بیشتر موارد، به این معنی است که یک یا چند شرط دسترسی صحیح نیستند.
علل رایج شامل موارد زیر است:
  • شما از رمز عبور ورود به حساب NiceNIC خود به جای رمز عبور API استفاده می‌کنید
  • رمز عبور API در تنظیمات API شما تنظیم نشده است
  • سربرگ Authیاization وجود ندارد یا به درستی قالب‌بندی نشده است
  • نام کاربری یا رمز مخفی API اشتباه است
  • درخواست از یک آدرس IP که در لیست سفید قرار ندارد ارسال می‌شود
  • آدرس IP واقعی خروجی سرور شما متفاوت از آدرسی است که اضافه کرده‌اید
  • حساب شما به سطح نمایندگی فروش واجد شرایط ارتقا نیافته است
  • درخواست به نقطه پایان اشتباه ارسال شده است
  • Content-نوع درخواست یا قالب JSON نادرست است
  • WHMCS از اعتبارنامه API قدیمی، نادرست یا ناقص استفاده می‌کند
درخواست API شما باید از یک آدرس IP سرور ارسال شود که به تنظیمات API شما اضافه شده است. رمز عبور API شما باید با رمز عبور ورود به حساب NiceNIC شما متفاوت باشد.

اگر از WHMCS استفاده می‌کنید، تأیید کنید که سرور WHMCS درخواست‌ها را از همان آدرس IP خروجی ارسال می‌کند که به تنظیمات API NiceNIC خود اضافه کرده‌اید.


علت 1: شما از رمز عبور ورود به حساب به جای رمز عبور API استفاده می‌کنید
این یکی از علل رایج خطاهای احراز هویت NiceNIC API است. رمز عبور ورود به حساب NiceNIC شما و رمز عبور API نباید یکسان باشند. رمز عبور API باید جداگانه در تنظیمات API شما پیکربندی شود.

چگونه این مشکل را برطرف کنیم؟
  1. وارد حساب NiceNIC خود شوید.
  2. به بخش نمایندگی فروش بروید.
  3. تنظیمات API را باز کنید.
  4. رمز عبور API‌ای تنظیم کنید که با رمز عبور ورود به حساب NiceNIC شما متفاوت باشد.
  5. یکپارچه‌سازی API یا پیکربندی WHMCS خود را با رمز عبور API صحیح به‌روزرسانی کنید.
  6. دوباره درخواست API را آزمایش کنید.
برای راهنمای تنظیم موجود NiceNIC API، این موارد را مرور کنید:
https://nicenic.com/suppیاt/API-NiceNIC-3824


علت 2: سربرگ Authیاization وجود ندارد یا اشتباه است
NiceNIC API v2 نیاز به یک سربرگ HTTP Authیاization دارد. قالب مستند شده به این صورت است: Authیاization: username:api_secret
اگر سربرگ گم شده، اشتباه نوشته شده، به درستی رمزگذاری نشده یا به قالب اشتباه ارسال شود، درخواست API ممکن است احراز هویت نشود.

چگونه این مشکل را برطرف کنیم؟
  • تأیید کنید که درخواست شما شامل سربرگ Authیاization است.
  • تأیید کنید که نام کاربری درست است.
  • تأیید کنید که رمز مخفی API، رمز عبور API شما است، نه رمز عبور ورود به حساب.
  • بررسی کنید که فضای اضافی قبل یا بعد از نام کاربری یا رمز مخفی API نباشد.
  • تأیید کنید که سرویس‌دهنده HTTP، چارچوب، یا ماژول WHMCS شما سربرگ Authیاization را حذف نمی‌کند.
  • تأیید کنید که سرور یا پروکسی شما سربرگ‌های سفارشی را مسدود نمی‌کند.
از مستندات رسمی API v2 برای قالب اتصال کنونی استفاده کنید:
https://nicenic.com/reseller/apiv2.php


علت 3: آدرس IP سرور شما در لیست سفید نیست
تنظیمات API NiceNIC نیاز به آدرس IP دارد که اجازه دسترسی به API شما را دارد. اگر درخواست شما از یک آدرس IP که اضافه نشده است بیاید، حتی اگر نام کاربری و رمز عبور API درست باشند، احراز هویت ممکن است شکست بخورد.

چگونه این مشکل را برطرف کنیم؟
  1. از توسعه‌دهنده یا ارائه‌دهنده میزبانی خود بخواهید آدرس IP عمومی خروجی سروری که استفاده می‌کنید را تأیید کند.
  2. وارد حساب NiceNIC خود شوید.
  3. به بخش نمایندگی فروش > تنظیمات API بروید.
  4. آدرس IP صحیح مجاز به دسترسی به API خود را اضافه کنید.
  5. تنظیمات را ذخیره کنید.
  6. یک درخواست آزمایشی دیگر از همان سرور ارسال کنید.

علت 4: آدرس IP خروجی واقعی شما با آدرسی که اضافه کرده‌اید متفاوت است
آدرس IP که در پنل کنترل میزبانی خود مشاهده می‌کنید همیشه با آدرس IP استفاده شده برای درخواست‌های خروجی API یکی نیست.
این خصوصاً زمانی اتفاق می‌افتد که سیستم شما پشت موارد زیر اجرا شود:
  • یکفایروال
  • یک تعادل بار
  • یک پروکسی
  • یک دروازه NAT
  • یک محیط کانتینریزه‌شده
  • یک شبکه میزبانی ابری
  • یک سرور WHMCS جداگانه
برای مثال، وب‌سایت شما ممکن است از یک آدرس IP استفاده کند، در حالی که سرور بک‌اند یا نصب WHMCS شما درخواست‌های API را از طریق یک آدرس IP خروجی دیگر ارسال می‌کند.
چگونه این مشکل را برطرف کنیم؟
  • از ارائه‌دهنده میزبانی خود بخواهید آدرس IP واقعی خروجی که برای درخواست‌های API استفاده می‌شود را تأیید کند.
  • آدرس IP خروجی سروری که درخواست API را ارسال می‌کند بررسی کنید، نه فقط آدرس IP وب‌سایت.
  • اگر WHMCS روی سرور جداگانه‌ای نصب شده است، آدرس IP خروجی آن سرور را در لیست سفید قرار دهید.
  • اگر زیرساخت شما چندین آدرس IP خروجی دارد، تأیید کنید کدام IP واقعاً توسط درخواست API استفاده می‌شود.
  • تنظیمات API NiceNIC خود را با آدرس IP صحیح به‌روزرسانی کنید.

علت 5: حساب شما هنوز برای دسترسی به API واجد شرایط نیست
دسترسی API NiceNIC برای کاربران نمایندگی فروش واجد شرایط طراحی شده است. اگر حساب شما به سطح نمایندگی فروش ارتقا نیافته یا دسترسی نمایندگی فروش برای حساب شما فعال نشده باشد، ممکن است تنظیمات API در دسترس نباشد یا احراز هویت API شکست بخورد.

چگونه این مشکل را برطرف کنیم؟
  • تأیید کنید که حساب NiceNIC شما به سطح نمایندگی فروش ارتقا یافته است.
  • بررسی کنید آیا تنظیمات API در بخش نمایندگی فروش موجود است یا خیر.
  • برنامه نمایندگی فروش و اطلاعات سطح نمایندگی فروش را مرور کنید.
  • اگر ارتقاء نمایندگی فروش انجام شده اما دسترسی به API هنوز در دسترس نیست، با پشتیبانی NiceNIC تماس بگیرید.
صفحات مرتبط:
https://nicenic.com/reseller/
https://nicenic.com/suppیاt/API-فروشنده-سطح-3823


علت 6: درخواست شما به نقطه پایان اشتباه فرستاده شده است
NiceNIC API v2 درخواستی که به نقطه پایان مستند API v2 ارسال نشده باشد، ممکن است احراز هویت یا پردازش درخواست شکست بخورد.

اگر کد شما از نقطه پایان قدیمی، URL نادرست، عدم داشتن اسلش، یا نسخه متفاوت API استفاده می‌کند، ممکن است احراز هویت یا پردازش درخواست شکست بخورد.
چگونه این مشکل را برطرف کنیم؟
  • تأیید کنید که یکپارچه‌سازی شما به https://api.NiceNIC/v2/ اشاره دارد.
  • بررسی کنید که هیچ نقطه پایان مرحله‌ای، شنی یا قدیمی هنوز در کد شما تنظیم نشده باشد.
  • بررسی کنید که WHMCS یا ماژول سفارشی شما از نقطه پایان کنونی استفاده می‌کند.
  • لاگ‌های سرور خود را مرور کنید تا URL دقیق درخواست شده را تأیید کنید.

علت 7: Content-نوع یا قالب JSON اشتباه است
NiceNIC API v2 پاسخ‌های JSON را بازمی‌گرداند و انتظار دارد درخواست‌های API قالب مستند شده را دنبال کنند.
درخواست شما باید شامل:
Content-نوع: application/json

اگر بدنه درخواست JSON معتبر نباشد، پارامترهای لازم جاافتاده باشند، یا Content-نوع به درستی تنظیم نشده باشد، درخواست API ممکن است قبل از اجرای عملیات مورد نظر، شکست بخورد.
چگونه این مشکل را برطرف کنیم؟
  • Content-نوع را به application/json تنظیم کنید.
  • اطمینان حاصل کنید که بدنه درخواست JSON معتبر است.
  • تأیید کنید که پارامترهای لازم درج شده‌اند.
  • تأیید کنید که نام پارامترها با مستندات API مطابقت دارد.
  • بررسی کنید که کلاینت HTTP شما فرمت بدنه درخواست را تغییر نمی‌دهد.
  • در طول آزمایش فرمت درخواست را لاگ کنید، اما هرگز اعتبارنامه کامل API را به صورت متن ساده لاگ نکنید.

علت 8: اعتبارنامه API WHMCS به درستی پیکربندی نشده است
اگر از WHMCS استفاده می‌کنید، خطای احراز هویت ممکن است ناشی از پیکربندی ماژول ثبت‌کننده WHMCS باشد نه کد API سفارشی شما.

علل رایج مرتبط با WHMCS شامل:
  • ماژول WHMCS از رمز عبور API اشتباه استفاده می‌کند
  • آدرس IP خروجی سرور WHMCS در لیست سفید نیست
  • نام کاربری یا مقدار حساب نمایندگی فروش به اشتباه وارد شده است
  • نصب WHMCS از جزئیات پیکربندی قدیمی استفاده می‌کند
  • محیط cron یا ماژول WHMCS درخواست‌ها را از سروری دیگر ارسال می‌کند
  • تنظیمات ماژول WHMCS تغییر کرده اما به‌درستی ذخیره نشده است
چگونه این مشکل را برطرف کنیم
  1. تنظیمات ماژول ثبت‌کننده WHMCS خود را باز کنید.
  2. نام کاربری و رمز عبور API NiceNIC را تأیید کنید.
  3. تأیید کنید که آدرس IP خروجی سرور WHMCS در تنظیمات API NiceNIC در لیست سفید است.
  4. بررسی کنید که WHMCS از جزئیات یکپارچه‌سازی کنونی NiceNIC API استفاده می‌کند.
  5. قبل از فعال کردن سفارش‌های زنده، یک عملیات کم‌ریسک مانند بررسی موجودی دامنه را آزمایش کنید.
صفحه یکپارچه‌سازی NiceNIC WHMCS را در اینجا مرور کنید:
https://nicenic.com/reseller/whmcs.php


چک‌لیست مرحله به مرحله برای رفع مشکل
قبل از ارسال تیکت پشتیبانی این چک‌لیست را استفاده کنید.
  1. تأیید کنید که حساب NiceNIC شما به نمایندگی فروش دسترسی دارد.
  2. تنظیمات API را در بخش نمایندگی فروش باز کنید.
  3. رمز عبور API‌ای تنظیم کنید که متفاوت از رمز عبور ورود به حساب است.
  4. تأیید کنید که یکپارچه‌سازی API شما از رمز عبور API استفاده می‌کند، نه رمز عبور ورود به حساب.
  5. فرمت سربرگ Authیاization را تأیید کنید: username:api_secret.
  6. نقطه پایان درخواست را تأیید کنید: https://api.NiceNIC/v2/.
  7. تأیید کنید که Content-نوع به application/json تنظیم شده است.
  8. تأیید کنید که بدنه درخواست JSON معتبر است.
  9. تأیید کنید که آدرس IP خروجی سرور در لیست سفید است.
  10. اگر از WHMCS استفاده می‌کنید، آدرس IP خروجی سرور WHMCS را تأیید کنید.
  11. ابتدا یک عملیات API کم‌ریسک را آزمایش کنید.
  12. زمان درخواست، عمل، دامنه، کد پاسخ، و پیام پاسخ را ثبت کنید.


اگر هنوز به کمک نیاز داشتید چه اطلاعاتی به پشتیبانی NiceNIC ارسال کنید
اگر خطای احراز هویت پس از تکمیل چک‌لیست همچنان ادامه داشت، یک تیکت پشتیبانی با اطلاعات فنی کافی ارسال کنید تا NiceNIC بتواند مشکل را به طور مؤثر بررسی کند.

لطفاً موارد زیر را شامل کنید:
نام کاربری حساب NiceNIC شما یا شناسه حساب نمایندگی فروش
عمل API که تلاش کرده‌اید
زمان و منطقه زمانی درخواست
نام دامنه که در تست استفاده شده است، در صورت وجود
آدرس IP خروجی سروری که درخواست ارسال شده
نقطه پایان کامل API درخواست شده
کد پاسخ و پیام پاسخ برگشتی توسط API
اینکه آیا از کد سفارشی یا WHMCS استفاده می‌کنید
نسخه WHMCS شما، اگر WHMCS دخیل است
تصاویر مرتبط، بدون شامل اعتبارنامه حساس

رمز عبور کامل API، رمز عبور ورود حساب، یا اعتبارنامه خصوصی سرور خود را در تیکت پشتیبانی ارسال نکنید.
https://nicenic.com/suppیاt/تماس-Us-3834


پرسش‌های متداول
چرا درخواست NiceNIC API v2 من خطای احراز هویت برمی‌گرداند؟
علل رایج عبارتند از رمز عبور API نادرست، نبودن یا اشتباه بودن سربرگ Authیاization، نشانی IP سرور غیرلیست سفیدشده، آدرس IP خروجی اشتباه، دسترسی نمایندگی فروش نامعتبر، نقطه پایان اشتباه، یا پیکربندی نادرست WHMCS.

آیا باید از رمز عبور ورود حساب NiceNIC خود برای احراز هویت API استفاده کنم؟
خیر. باید رمز عبور جداگانه‌ای را در تنظیمات API خود تنظیم کنید. رمز عبور API باید متفاوت از رمز عبور ورود حساب شما باشد.

چه سربرگ Authیاization‌ای باید برای NiceNIC API v2 استفاده کنم؟
قالب مستند شده سربرگ Authیاization به صورت username:api_secret است. همچنین باید Content-نوع: application/json را در سربرگ درخواست بگنجانید.

چرا پس از تنظیم رمز عبور صحیح، API هنوز شکست می‌خورد؟
ممکن است درخواست از آدرس IP‌ای آمده باشد که در لیست سفید نیست. آدرس IP واقعی خروجی سرور، نصب WHMCS، یا برنامه بک‌اند خود را تأیید کنید.

آیا WHMCS از همان IP سرور وب‌سایت من استفاده می‌کند؟
نه همیشه. ممکن است WHMCS روی سرور متفاوتی نصب شده باشد، پشت پروکسی یا در محیطی با IP خروجی متفاوت. قبل از افزودن آن به تنظیمات API NiceNIC، IP خروجی واقعی را تأیید کنید.

آیا NiceNIC می‌تواند خطاهای احراز هویت ناشی از پیکربندی سرور من را برطرف کند؟
NiceNIC می‌تواند به بررسی دسترسی سمت ثبت‌کننده، تنظیمات API و الزامات اتصال مستند کمک کند. مشکلات سمت سرور مانند قوانین فایروال، مسیر IP خروجی، رفتار پروکسی، پیکربندی ماژول WHMCS، و کد سفارشی ممکن است نیاز به بررسی توسط توسعه‌دهنده یا ارائه‌دهنده میزبانی شما داشته باشند.

پس از رفع مشکل احراز هویت اول چه چیزهایی باید آزمایش کنم؟
با یک عمل API کم‌ریسک مانند بررسی موجودی حساب شروع کنید، بررسی در دسترس بودن دامنه، جستجوی قیمت یا بازیابی فهرست دامنه قبل از فعال کردن سفارش‌های ثبت‌نام، تمدید یا انتقال زنده.
نیاز به کمک دارید؟ ما همیشه در خدمت شما هستیم. ارسال تیکت
حق نشر © 2006-2026 شرکت بین‌المللی NiceNIC محدود تمام حقوق محفوظ است