X
منتشر شده: 2026-05-25 | به‌روزرسانی شده: 2026-05-25
چگونه از NiceNIC Reseller API v2 استفاده کنیم


NiceNIC Reseller API v2 به نمایندگان فروش دامنه، ارائه‌دهندگان میزبانی، توسعه‌دهندگان و کاربران WHMCS کمک می‌کند تا عملیات دامنه را از طریق اتصال مستقیم API خودکار کنند.


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


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

اگر از WHMCS استفاده می‌کنید، می‌توانید به جای ساختن هر جریان کاری API به صورت دستی، از طریق ادغام NiceNIC WHMCS نیز متصل شوید.


چه کسانی باید از NiceNIC Reseller API v2 استفاده کنند؟
NiceNIC Reseller API v2 برای کاربرانی طراحی شده که بیش از مدیریت دستی دامنه نیاز دارند.
این API برای موارد زیر مناسب است:
  • نمایندگان فروش دامنه که دامنه را به مشتریان خود می‌فروشند
  • ارائه‌دهندگان میزبانی که می‌خواهند ثبت دامنه را با بسته‌های میزبانی ترکیب کنند
  • آژانس‌های وب که بسیاری از دامنه‌های مشتریان را مدیریت می‌کنند
  • توسعه‌دهندگانی که سیستم‌های جستجو یا ثبت دامنه سفارشی می‌سازند
  • کاربران WHMCS که می‌خواهند عملیات دامنه را خودکار کنند
  • کسب‌وکارهایی که نیاز به مدیریت حجم زیادی از دامنه یا جریان‌های کاری تکراری دامنه دارند
اگر فقط گهگاه یک یا دو دامنه ثبت می‌کنید، پنل کنترل NiceNIC ممکن است کافی باشد. اگر دامنه‌های زیادی مدیریت می‌کنید یا می‌خواهید پلتفرم خودتان به طور مستقیم با NiceNIC ارتباط برقرار کند، API نماینده فروش جریان کاری بهتری است.


با NiceNIC Reseller API v2 چه کارهایی می‌توانید انجام دهید؟
NiceNIC Reseller API v2 می‌تواند بخش‌های مهمی از چرخه عمر دامنه را خودکار کند.
بسته به وضعیت حساب شما، مجوزهای API، پسوند دامنه، قوانین رجیستری و پشتیبانی محصول موجود، توابع API ممکن است شامل موارد زیر باشد:
  • بررسی در دسترس بودن دامنه
  • ثبت نام دامنه‌ها
  • تمدید دامنه‌های موجود
  • انتقال دامنه‌ها با کدهای EPP
  • لیست کردن دامنه‌ها در حساب شما
  • دریافت جزئیات دامنه
  • به‌روزرسانی نام‌سرورها
  • به‌روزرسانی اطلاعات تماس دامنه
  • بررسی قیمت دامنه
  • مدیریت رکوردهای DNS
  • ایجاد و مدیریت نام‌سرورهای فرزند
  • بررسی موجودی حساب
  • بازبینی تراکنش‌های حساب
  • اتصال به جریان‌های کاری WHMCS
برخی عملیات ممکن است به قوانین رجیستری، الزامات TLD، وضعیت دامنه، تأیید حساب، موجودی پرداخت یا نیازهای مستندات اضافی بستگی داشته باشد. همیشه پاسخ API و قوانین مربوط به دامنه را بررسی کنید قبل از اینکه فرض کنید همه پسوندها به یک شکل رفتار می‌کنند.


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


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

آماده خودکارسازی خدمات دامنه هستید؟
به حساب نمایندگی NiceNIC ارتقا دهید و ثبت، تمدید، انتقال دامنه، DNS و جریان‌های کاری WHMCS را از طریق Reseller API v2 متصل کنید.



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


مرحله 3: یک رمز عبور API جداگانه تنظیم کنید
رمز عبور API شما باید با رمز ورود حساب NiceNIC شما متفاوت باشد.  این موضوع برای امنیت و عیب‌یابی مهم است. اگر از رمز عبور اشتباه استفاده کنید یا به جای رمز عبور API، رمز ورود حساب را استفاده کنید، تأیید هویت ممکن است شکست بخورد.
روش توصیه شده:
  • از رمز عبور API قوی استفاده کنید
  • رمز ورود حساب خود را مجدداً استفاده نکنید
  • مدارک API را به طور ایمن نگهداری کنید
  • مدارک API را از طریق چت ناامن یا تیکت‌های عمومی ارسال نکنید
  • زمانی که یک توسعه‌دهنده، فروشنده یا کارمند سابق دیگر نیازی به دسترسی ندارد مدارک را تغییر دهید


مرحله 4: آدرس IP سرور خود را در لیست سفید قرار دهید

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

قبل از ذخیره تنظیمات API خود، با توسعه‌دهنده یا ارائه‌دهنده میزبانی خود آدرس IP خروجی صحیح را تأیید کنید. اگر آدرس IP اشتباه اضافه شود، احتمال دارد درخواست API شما حتی اگر نام کاربری و رمز عبور API صحیح باشند، انجام نشود.

مشکلات رایج مرتبط با IP شامل:
  • آدرس IP سرور وب سایت با آدرس IP خروجی درخواست API متفاوت است
  • WHMCS در پشت فایروال، پراکسی یا دروازه NAT میزبانی می‌شود
  • ارائه‌دهنده میزبانی آدرس IP سرور را تغییر داده است
  • چندین سرور درخواست‌های API را ارسال می‌کنند ولی فقط یک IP در لیست سفید است
  • یک سرور توسعه کار می‌کند اما سرور تولید در لیست سفید نیست

مرحله 5: اتصال به نقطه پایان NiceNIC API v2

پس از پیکربندی رمز عبور API و لیست سفید IP، سیستم شما می‌تواند درخواست‌ها را به نقطه پایان NiceNIC API v2 ارسال کند.  API از درخواست‌های HTTP استفاده و پاسخ‌ها را به صورت JSON برمی‌گرداند. درخواست شما باید شامل هدرهای مجوز و نوع محتوا باشد.

بدنه درخواست دقیق به عملکرد API که می‌خواهید انجام دهید بستگی دارد. به عنوان مثال، بررسی در دسترس بودن دامنه، ثبت دامنه، تمدید دامنه، به‌روزرسانی نام‌سرورها یا بررسی موجودی حساب ممکن است پارامترهای متفاوتی نیاز داشته باشد.

همیشه هنگام ساخت یا به‌روزرسانی یکپارچه‌سازی خود، مستندات جدید NiceNIC API v2 را دنبال کنید.

آیا به مستندات فنی نیاز دارید؟
از مستندات رسمی NiceNIC Reseller API v2 برای بازبینی تأیید هویت، کدهای پاسخ، عملکردهای دامنه، عملکردهای DNS، عملکردهای صورتحساب و پشتیبانی WHMCS استفاده کنید.


مرحله 6: ابتدا یک عملیات ایمن API را آزمایش کنید
قبل از اجرای عملیات پرداختی یا روبروی مشتری، ابتدا یک عملکرد کم‌ریسک API را امتحان کنید.

توصیه می‌شود اولین آزمایش‌ها:
  • بررسی موجودی حساب
  • بررسی در دسترس بودن دامنه
  • دریافت قیمت دامنه
  • لیست دامنه‌ها
تا زمانی که تأیید هویت، لیست سفید IP، قالب درخواست و مدیریت پاسخ به درستی کار کنند، از شروع با ثبت یا انتقال دامنه زنده خودداری کنید.

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


مرحله 7: اگر از صورتحساب WHMCS استفاده می‌کنید، WHMCS را متصل کنید
اگر کسب‌وکار شما از WHMCS استفاده می‌کند، ممکن است نیازی به ساختن هر جریان کاری از صفر نداشته باشید.

NiceNIC ادغام WHMCS را برای عملیات ثبت دامنه ارائه می‌دهد. این می‌تواند به خودکارسازی جریان‌های کاری معمول نمایندگان فروش مانند بررسی در دسترس بودن، ثبت، تمدید، انتقال و دریافت اطلاعات دامنه کمک کند.

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

استفاده از WHMCS؟
WHMCS را با NiceNIC متصل کنید تا جریان‌های کاری ثبت، تمدید، انتقال و مدیریت دامنه را خودکار کنید.



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

2. اجازه دسترسی IP داده نشده یا اتصال ناموفق است

اگر آدرس IP شما اجازه دسترسی ندارد، درخواست API ممکن است قبل از پردازش عملیات رد شود.

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

3. قالب درخواست نامعتبر
اگر بدنه درخواست، هدر یا پارامترها به درستی قالب‌بندی نشده باشند، API ممکن است پاسخ خطا بدهد.
بررسی کنید:
  • Content-نوع روی application/json تنظیم شده است
  • بدنه درخواست JSON معتبر است
  • پارامترهای مورد نیاز وارد شده است
  • قالب دامنه صحیح است
  • نام عملیات با مستندات API مطابقت دارد

4. ثبت دامنه ناموفق بود

درخواست ثبت دامنه ممکن است به دلایلی غیر از خود اتصال API ناموفق باشد.
علل ممکن شامل:
  • دامنه دیگر در دسترس نیست
  • پسوند دامنه الزامات ثبت خاصی دارد
  • رجیستری درخواست مدارک اضافی دارد
  • موجودی حساب کافی نیست
  • اطلاعات تماس دامنه ناقص یا نامعتبر است
  • رجیستری درخواست را رد کرده است
پیام پاسخ API را بررسی کنید و ببینید آیا پسوند نیاز به الزامات خاص رجیستری دارد یا خیر.

5. تمدید یا انتقال ناموفق بود
عملیات تمدید و انتقال ممکن است به پسوند دامنه، وضعیت دامنه، قوانین رجیستری، جدول زمانی انقضا، قفل انتقال، کد EPP و موجودی حساب وابسته باشد.

برای مسائل انتقال، بررسی کنید:
  • دامنه واجد شرایط انتقال است
  • دامنه در رجیستری فعلی باز است
  • کد EPP صحیح است
  • دامنه توسط رجیستری یا محدودیت‌های سیاست مسدود نشده است
  • ایمیل ثبت‌کننده یا فرآیند تأیید انتقال در صورت نیاز تکمیل شده است


NiceNIC چه کاری می‌تواند انجام دهد و چه کاری نمی‌تواند

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

با این حال، برخی عملیات دامنه به قوانین رجیستری، سیاست‌های پسوند، وضعیت تأیید، وضعیت پرداخت، وضعیت سوءاستفاده/رعایت قوانین یا سیستم‌های ثالث وابسته است.

به عنوان مثال:
  • برخی از پسوندها قبل از ثبت به مدارک خاص نیاز دارند
  • برخی دامنه‌ها ممکن است قفل شده، منقضی شده، در حال تأیید یا محدود شده توسط سیاست رجیستری باشند
  • برخی درخواست‌های انتقال ممکن است نیاز به تأیید از رجیستری از دست‌دهنده یا تماس ثبت‌کننده داشته باشند
  • تغییرات DNS ممکن است زمان‌بر باشد تا در سراسر جهان منتشر شود
  • رفتار WHMCS ممکن است به نسخه WHMCS، تنظیمات ماژول، محیط سرور و پیکربندی کرون شما بستگی داشته باشد
به همین دلیل، یکپارچه‌سازی شما همیشه باید پاسخ API را بخواند و ذخیره کند و به فرض موفقیت‌آمیز بودن هر عملی اکتفا نکند.


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


سؤالات متداول
1. آیا برای استفاده از NiceNIC Reseller API v2 به حساب نمایندگی نیاز دارم؟
بله. NiceNIC Reseller API v2 برای کاربران نمایندگی واجد شرایط در نظر گرفته شده است. اگر نمی‌توانید به تنظیمات API دسترسی پیدا کنید، بررسی کنید که آیا حساب شما به سطح نمایندگی ارتقا یافته است یا خیر.

2. آیا می‌توانم رمز ورود حساب NiceNIC خود را به عنوان رمز عبور API استفاده کنم؟
خیر. برای امنیت و پیکربندی صحیح، رمز عبور API شما باید متفاوت از رمز ورود حساب شما باشد.

3. چرا درخواست API من خطای تأیید هویت برمی‌گرداند؟
خطاهای تأیید هویت معمولاً به دلیل رمز عبور API اشتباه، نبود هدر Authیاization، نام کاربری نادرست، نبود آدرس IP در لیست سفید یا ارسال درخواست از آدرس IP خروجی متفاوت سرور است.

4. آیا می‌توانم NiceNIC API v2 را با WHMCS استفاده کنم؟
بله. NiceNIC ادغام WHMCS را برای عملیات رجیستری دامنه مانند بررسی در دسترس بودن، ثبت، تمدید، انتقال و دریافت اطلاعات دامنه فراهم می‌کند.

5. آیا می‌توانم همه پسوندهای دامنه را از طریق API ثبت کنم؟
همیشه خیر. ثبت دامنه به در دسترس بودن پسوند، قوانین رجیستری، موجودی حساب، الزامات تأیید و محدودیت‌های خاص پسوند وابسته است. برخی از پسوندها ممکن است مدارک اضافی یا بازبینی دستی نیاز داشته باشند.

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


شروع به خودکارسازی خدمات دامنه با NiceNIC کنید
NiceNIC Reseller API v2 به نمایندگان فروش، ارائه‌دهندگان میزبانی، توسعه‌دهندگان و کاربران WHMCS امکان می‌دهد به صورت مستقیم جستجو، ثبت، تمدید، انتقال، DNS و جریان‌های کاری حساب دامنه را خودکار کنند.

نیاز به کمک دارید؟ ما همیشه در خدمت شما هستیم. ارسال تیکت
حق نشر © 2006-2026 شرکت بین‌المللی NiceNIC محدود تمام حقوق محفوظ است