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 заявката не може да бъде потвърдена. Започнете с проверка дали акаунтът ви има достъп на дилър, дали използвате API паролата вместо паролата за влизане в акаунта си в NiceNIC, дали заглавката 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 адрес на сървъра ви е различен от IP адреса, който сте добавили
  • Акаунтът ви не е надграден до подходящ дилърски Tier
  • Заявката е изпратена към грешна крайна точка
  • Content-Тип на заявката или JSON форматът са неправилни
  • WHMCS използва остарели, неправилни или непълни API данни за достъп
Вашата API заявка трябва да се изпраща от IP адрес на сървър, който е добавен към настройките на API. Вашата API парола трябва да е различна от паролата за влизане в акаунта NiceNIC.

Ако използвате WHMCS, уверете се, че WHMCS сървърът изпраща заявките от същия изходящ IP адрес, който сте добавили към настройките на вашия NiceNIC API.


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

Как да го поправите?
  1. Помолете вашия разработчик или доставчик на хостинг да потвърди публичния изходящ IP адрес, който се използва от вашия сървър.
  2. Влезте в своя акаунт NiceNIC.
  3. Отидете в Дилър > Настройка на API.
  4. Добавете правилния IP адрес, който е разрешен за достъп до вашия API.
  5. Запазете настройката.
  6. Изпратете друга тестова заявка от същия сървър.

Причина 4: Вашият реален изходящ IP е различен от добавения IP
IP адресът, който виждате в контролния панел на хостинга, не винаги е същият IP, използван за изходящи API заявки.
Това е особено често срещано, когато вашата система работи зад:
  • Файъруол
  • Балансировач на натоварване
  • Прокси
  • NAT шлюз
  • Контейнеризирана среда
  • Облачна хостинг мрежа
  • Отделен WHMCS сървър
Например, уебсайтът ви може да използва един IP адрес, а бекенд сървърът ви или инсталацията на WHMCS изпраща API заявки през друг изходящ IP адрес.
Как да го поправите?
  • Помолете вашия хостинг доставчик да потвърди реалния изходящ IP, използван за API заявки.
  • Проверете изходящия IP адрес от сървъра, който изпраща API заявката, а не само IP адреса на уебсайта.
  • Ако WHMCS е инсталиран на отделен сървър, добавете в белия списък изходящия IP на WHMCS сървъра.
  • Ако инфраструктурата ви има няколко изходящи IP адреса, потвърдете кой IP всъщност се използва от API заявката.
  • Актуализирайте настройките на NiceNIC API с правилния IP адрес.

Причина 5: Вашият акаунт все още не е с право на достъп до API
Достъпът до NiceNIC API е предназначен за допустими потребители дилъри. Ако акаунтът ви не е надграден до дилърски Tier или ако достъпът на дилър не е активиран за акаунта ви, настройките на API може да не са налични или удостоверяването на API да се провали.

Как да го поправите?
  • Потвърдете, че акаунтът ви NiceNIC е надграден до дилърски Tier.
  • Проверете дали Настройка на API е налична под навигацията за дилъри.
  • Прегледайте програмата за дилъри и информацията за нивото на дилърството.
  • Свържете се с поддръжката на NiceNIC, ако надграждането до дилър е завършено, но достъпът до API все още не е наличен.
Свързани страници:
https://nicenic.com/reseller/
https://nicenic.com/suppилиt/API-Реселър-Ниво-3823


Причина 6: Вашата заявка е изпратена към грешна крайна точка
NiceNIC API v2 заявките трябва да се изпращат към документираната крайна точка на API v2.

Ако вашият код използва стара крайна точка, грешен URL, липсващ наклонен знак или различна версия на API, удостоверяването или обработката на заявката може да се провали.
Как да го поправите?
  • Потвърдете, че вашата интеграция сочи към https://api.NiceNIC/v2/.
  • Проверете дали в кода ви още са конфигурирани тестови, sиbox или стари крайни точки.
  • Проверете дали WHMCS или вашият персонализиран модул използват текущата крайна точка.
  • Прегледайте сървърните си логове, за да потвърдите точния URL, който се заявява.

Причина 7: Content-Тип или JSON форматът са неправилни
NiceNIC API v2 връща JSON отговори и очаква API заявките да следват документирания формат на заявката.
Вашата заявка трябва да включва:
Content-Тип: application/json

Ако тялото на заявката не е валиден JSON, липсват задължителни параметри или Content-Тип не е правилно зададен, API заявката може да се провали преди да се обработи желаното действие.
Как да го поправите?
  • Задайте Content-Тип на application/json.
  • Уверете се, че тялото на заявката е валиден JSON.
  • Потвърдете, че включвате задължителните параметри.
  • Потвърдете, че имената на параметрите съответстват на документацията за API.
  • Проверете дали вашият HTTP клиент променя формата на тялото на заявката.
  • Логвайте формата на заявката по време на тестове, но никога не записвайте пълните API данни за достъп в обикновен текст.

Причина 8: Данните за достъп към WHMCS API не са конфигурирани правилно
Ако използвате WHMCS, грешка при удостоверяване може да се дължи на конфигурацията на регистрационния модул във WHMCS, а не на вашия персонализиран API код.

Чести причини, свързани с WHMCS, включват:
  • WHMCS модулът използва грешна API парола
  • Изходящият IP на WHMCS сървъра не е в белия списък
  • Потребителското име или стойността на акаунта дилър е въведена неправилно
  • Инсталацията на WHMCS използва остаряла конфигурация
  • Cron или модула на WHMCS изпраща заявки от различен сървър
  • Настройките на модула на WHMCS са променени, но не са запазени правилно
Как да го поправите
  1. Отворете настройките на регистрационния модул на WHMCS.
  2. Потвърдете потребителското име и API паролата за NiceNIC API.
  3. Потвърдете, че изходящият IP на WHMCS сървъра е в белия списък в настройките на NiceNIC API.
  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, ако се ползва
Подходящи екранни снимки, без чувствителни данни за достъп

Не изпращайте пълната си API парола, парола за влизане в акаунта или лични данни за сървъра в заявка за поддръжка.
https://nicenic.com/suppилиt/Контакт-Us-3834


Често задавани въпроси
Защо моята заявка към NiceNIC API v2 връща грешка при удостоверяване?
Най-честите причини са неправилна API парола, липсваща или неправилна заглавка Authилиization, сървърен IP адрес, който не е в белия списък, грешен изходящ IP адрес, недопустим достъп за дилър, грешна крайна точка или неправилна конфигурация на WHMCS.

Трябва ли да използвам паролата за влизане в акаунта NiceNIC за удостоверяване на API?
Не. Трябва да зададете отделна API парола в настройките на API. API паролата трябва да е различна от паролата за влизане в акаунта NiceNIC.

Каква заглавка Authилиization трябва да използвам за NiceNIC API v2?
Документираният формат на заглавката Authилиization е username:api_secret. Трябва също да включите Content-Тип: application/json в заглавката на заявката.

Защо API все още не работи, след като съм задал правилната парола?
Заявката може да идва от IP адрес, който не е в белия списък. Потвърдете реалния изходящ IP адрес на вашия сървър, WHMCS инсталация или бекенд приложение.

Използва ли WHMCS същия сървърен IP като моя уебсайт?
Не винаги. WHMCS може да е инсталиран на различен сървър, зад прокси или в среда с различен изходящ IP. Потвърдете реалния изходящ IP преди да го добавите към настройките на NiceNIC API.

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

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