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 و جریانهای کاری حساب دامنه را خودکار کنند.