X
Публикувано: 2026-05-25 | Обновено: 2026-05-25
Как да започнете да използвате NiceNIC Reseller API v2


NiceNIC Reseller API v2 помага на препродажбите на домейни, доставчиците на хостинг, разработчиците и потребителите на WHMCS да автоматизират домейн операциите чрез директна API връзка.


С API-то, квалифицираните препродажби на NiceNIC могат да свържат своя собствен уебсайт, система за фактуриране, инсталация на WHMCS или персонализирана платформа, за да автоматизират често срещани работни процеси с домейни като проверка на наличност на домейн, регистрация на домейн, подновяване на домейн, трансфер на домейн, актуализации на nameserver-и, управление на DNS записи, проверка на баланс по сметката и преглед на транзакции. 


Бърз отговор
За да започнете да използвате NiceNIC Реселър API v2, трябва да надстроите своя NiceNIC акаунт до ниво препродажба, да конфигурирате настройките на API, да създадете API парола, която е различна от паролата за вход в акаунта, да добавите в списък с разрешени IP адреси адреса, който има право да достъпва API, и след това да свържете своята система с NiceNIC API v2 крайна точка.

Ако използвате WHMCS, можете също да се свържете чрез интеграцията на NiceNIC WHMCS вместо да създавате всеки API работен процес ръчно.


Кой трябва да използва NiceNIC Reseller API v2?
NiceNIC Reseller API v2 е предназначен за потребители, които се нуждаят от повече от ръчно управление на домейни.
Подходящ е за:
  • Препродажби на домейни, които продават домейни на собствените си клиенти
  • Доставчици на хостинг, които искат да комбинират регистрацията на домейн с хостинг пакети
  • Уеб агенции, управляващи много клиентски домейни
  • Разработчици, изграждащи персонализирани системи за търсене или регистрация на домейни
  • Потребители на WHMCS, които искат автоматизирани операции с домейни
  • Бизнеси, които се нуждаят от масово управление на домейни или повтарящи се работни процеси с домейни
Ако регистрирате само един или два домейна от време на време, контролният панел на NiceNIC може да е достатъчен. Ако управлявате много домейни или искате собствена платформа, която да комуникира директно с NiceNIC, Reseller API е по-добрият работен процес.


Какво можете да правите с NiceNIC Reseller API v2?
NiceNIC Reseller API v2 може да помогне за автоматизирането на важни части от жизнения цикъл на домейна.
В зависимост от статуса на вашия акаунт, разрешенията на API, разширението на домейна, правилата на регистъра и наличната продуктова поддръжка, функциите на API могат да включват:
  • Проверка на наличност на домейн
  • Регистрация на домейни
  • Подновяване на съществуващи домейни
  • Трансфер на домейни с EPP кодове
  • Изброяване на домейни в акаунта ви
  • Получаване на детайли за домейн
  • Актуализиране на nameserver-и
  • Актуализиране на контактната информация за домейн
  • Проверка на цени за домейн
  • Управление на DNS записи
  • Създаване и управление на поддомейни nameserver-и
  • Проверка на баланс по сметката
  • Преглед на транзакции
  • Свързване с работни процеси в 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 адреса на сървъра в списък с разрешени

Достъпът до NiceNIC API изисква 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 действието, което искате да изпълните. Например, проверка на наличност на домейн, регистрация на домейн, подновяване на домейн, актуализиране на nameserver-и или проверка на баланс по сметка може да изисква различни параметри.

Винаги следвайте най-новата документация на 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.
Възможни причини включват:
  • Домейнът вече не е наличен
  • TLD има специални изисквания за регистрация
  • Регистърът изисква допълнителни документи
  • Балансът по сметката не е достатъчен
  • Контактната информация за домейна е непълна или невалидна
  • Регистърът е отказал заявката
Прегледайте съобщението за отговора на API и проверете дали разширението има специални изисквания на регистъра.

5. Подновяване или трансфер не успя
Действията за подновяване и трансфер може да зависят от разширението на домейна, статуса на домейна, правилата на регистъра, сроковете на изтичане, блокиране на трансфер, EPP код, и баланс на сметката.

За проблеми с трансфера проверете:
  • Домейнът е допустим за трансфер
  • Домейнът е отключен при текущия регистратор
  • EPP кодът е правилен
  • Домейнът не е блокиран от регистър или политики
  • Електронната поща на регистранта или процесът по одобрение на трансфера е завършен, когато се изисква


Какво може и какво не може NiceNIC

NiceNIC предоставя достъп до API на страна на регистратора, инструменти за акаунти на препродажба, документация за API, ресурси за интеграция с WHMCS и поддръжка за домейн операции, налични през своята платформа.

Въпреки това, някои действия с домейни зависят от правила на регистъра, политики на разширенията, статус на верификация, статус на плащане, статус на злоупотреба/съответствие или трети страни системи.

Например:
  • Някои TLD-та могат да изискват специални документи преди регистрация
  • Някои домейни могат да бъдат заключени, изтекли, под верификация или ограничени от политика на регистъра
  • Някои заявки за трансфер могат да изискват одобрение от губещия регистратор или контакт на регистранта
  • Промените в DNS може да отнемат време за глобално разпространение
  • Поведението на WHMCS може да зависи и от версията ви на WHMCS, настройките на модула, сървърната среда и конфигурацията на cron
Поради това вашата интеграция винаги трябва да чете и съхранява отговора на API, вместо да приема, че всяко действие е успешно.


Препоръчителен първи работен процес за интеграция
Ако изграждате нова интеграция, използвайте тази последователност:
  • Надграждане до акаунт за препродажба
  • Конфигуриране на API парола и бял списък с IP адреси
  • Свързване към API v2 крайната точка
  • Тест на проверка на баланс по сметка
  • Тест на проверка на наличност на домейн
  • Тест на проверка на цени
  • Тест на актуализация на nameservers на безопасен вътрешен домейн
  • Преглед на кодове за отговор и обработка на грешки
  • Свързване на 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?
Не винаги. Регистрацията на домейн зависи от наличността на TLD, правилата на регистъра, баланс на акаунта, изисквания за верификация и ограничения специфични за разширението. Някои TLD може да изискват допълнителни документи или ръчен преглед.

6. Какво трябва да тествам преди да премина на живо?
Започнете с действия с нисък риск като проверка на баланса по сметка, проверка на наличност на домейн, проверка на цени и изброяване на домейни. Не активирайте живи клиентски поръчки, докато не потвърдите, че удостоверяването, списъкът с разрешени IP адреси, форматът на заявките, обработката на отговора и логиката за фактуриране работят коректно.


Започнете да автоматизирате домейн услуги с NiceNIC
NiceNIC Reseller API v2 предоставя на препродажби, доставчици на хостинг, разработчици и потребители на WHMCS директен начин да автоматизират търсене, регистрация, подновяване, трансфер, DNS и работни процеси по акаунт с домейни.

Имате нужда от помощ? Винаги сме насреща. Отворете билет за поддръжка
Авторски права © 2006-2026 NICENIC INTERNATIONAL GROUP CO., LIMITED Всички права запазени