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-адреси, яку ви додали
  • Ваш обліковий запис не оновлений до відповідного рівня реселера
  • Запит відправлено на неправильну кінцеву точку
  • Некоректний 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-запитів.
Це особливо характерно, якщо ваша система працює за:
  • Брандмауером (firewall)
  • Балансувальником навантаження
  • Проксі
  • Шлюзом NAT
  • Контейнеризованим середовищем
  • Хмарною мережею хостингу
  • Окремим сервером WHMCS
Наприклад, ваш вебсайт може використовувати одну IP-адресу, а ваш бекенд-сервер або інсталяція WHMCS надсилати API-запити з іншої вихідної IP-адреси.
Як виправити?
  • Запитайте у хостинг-провайдера реальну вихідну IP-адресу, що використовується для API-запитів.
  • Перевірте вихідну IP-адресу сервера, що надсилає запит API, а не лише IP-адресу вебсайту.
  • Якщо WHMCS встановлено на окремому сервері, додайте цю вихідну IP-адресу сервера WHMCS у білий список.
  • Якщо у вашій інфраструктурі використовується кілька вихідних IP-адрес, уточніть, яка з них фактично використовується для запитів API.
  • Оновіть налаштування NiceNIC API з правильною IP-адресою.

Причина 5: Ваш обліковий запис ще не має права на доступ до API
Доступ до NiceNIC API призначений для користувачів реселерів з відповідним статусом. Якщо ваш обліковий запис не оновлено до рівня реселера або доступ реселера не активовано для вашого облікового запису, налаштування API можуть бути недоступними або автентифікація API може не пройти.

Як виправити?
  • Переконайтеся, що ваш обліковий запис NiceNIC оновлено до рівня реселера.
  • Перевірте, чи доступне налаштування 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: Неправильна конфігурація облікових даних API WHMCS
Якщо ви використовуєте WHMCS, помилка автентифікації може бути пов’язана з налаштуваннями модуля реєстратора WHMCS, а не вашим власним кодом API.

Поширені причини, пов’язані з WHMCS, включають:
  • Модуль WHMCS використовує неправильний пароль API
  • Вихідна IP-адреса сервера WHMCS не додана у білий список
  • Неправильне введення імені користувача або значення облікового запису реселера
  • Встановлення WHMCS використовує застарілі конфігураційні дані
  • Середовище cron або модулю WHMCS надсилає запити з іншого сервера
  • Налаштування модуля WHMCS змінювалися, але не були збережені правильно
Як виправити
  1. Відкрийте налаштування модуля реєстратора WHMCS.
  2. Переконайтеся, що ім’я користувача NiceNIC API та пароль API правильні.
  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. Пароль 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 Всі права захищені