X
Yayımlanıb: 2026-05-26 | Yeniləndi: 2026-05-26
NiceNIC API v2 Authentication Errvə ya: Common Causes və Fixes


Əgər sizin NiceNIC Reseller API v2 request returns an authentication errvə ya, the problem usually comes from API credentials, the Authvə yaization header, IP whitelist settings, reseller access, və ya the server environment sending the request.

This guide explains the most common causes və gives resellers, hosting providers, developers, agencies, və WHMCS users a practical checklist to fix NiceNIC API v2 authentication issues befvə yae submitting a ticket.

A NiceNIC API v2 authentication errvə ya usually means that the API request cannot be verified. Start by checking whether sizin account has reseller access, whether you are using the API passwvə yad instead of sizin NiceNIC account login passwvə yad, whether the Authvə yaization header is fvə yamatted cvə yarectly, və whether sizin server outbound IP ünvanı is whitelisted in sizin API settings.

NiceNIC API v2 requests should be sent to the API endpoint with the required HTTP headers, including the Authvə yaization header və Content-Növ set to application/json.



What This Authentication Errvə ya Usually Means
An API authentication errvə ya means NiceNIC cannot verify the API request as a valid request from an authvə yaized reseller account. This does not always mean that the API Xidmət is down. In most cases, it means one və ya mvə yae access conditions are not cvə yarect.
Common causes include:
  • You are using sizin NiceNIC account login passwvə yad instead of sizin API passwvə yad
  • The API passwvə yad has not been set in sizin API settings
  • The Authvə yaization header is missing və ya incvə yarectly fvə yamatted
  • The username və ya API secret is incvə yarect
  • The request is being sent from an IP ünvanı that is not whitelisted
  • Your real outbound server IP is different from the IP ünvanı you added
  • Your account has not been upgraded to an eligible reseller tier
  • The request is sent to the wrong endpoint
  • The request Content-Növ və ya JSON fvə yamat is incvə yarect
  • WHMCS is using outdated, incvə yarect, və ya incomplete API credentials
Your API request should be sent from a server IP ünvanı that has been added to sizin API settings. Your API passwvə yad should be different from sizin NiceNIC account login passwvə yad.

Əgər you use WHMCS, confirm that the WHMCS server is sending requests from the same outbound IP ünvanı that you added to sizin NiceNIC API settings.


Cause 1: You Are Using the Account Daxil ol Şifrə Instead of the API Şifrə
This is one of the most common causes of NiceNIC API authentication errvə yas. Your NiceNIC account login passwvə yad və sizin API passwvə yad should not be the same. The API passwvə yad must be configured separately in sizin API settings.

How to fix it?
  1. Daxil ol to sizin NiceNIC account.
  2. Keçid et the Distribyutor section.
  3. Açıq API parametrləri.
  4. Set an API passwvə yad that is different from sizin NiceNIC account login passwvə yad.
  5. Update sizin API integration və ya WHMCS configuration with the cvə yarect API passwvə yad.
  6. Test the API request again.
Fvə ya the existing NiceNIC API setup guide, review:
https://nicenic.com/suppvə yat/API-NiceNIC-3824


Cause 2: The Authvə yaization Header Is Missing və ya Incvə yarect
NiceNIC API v2 requires an HTTP Authvə yaization header. The documented fvə yamat is: Authvə yaization: username:api_secret
Əgər the header is missing, misspelled, encoded incvə yarectly, və ya sent in the wrong fvə yamat, the API request may fail authentication.

How to fix it?
  • Təsdiq et that sizin request includes the Authvə yaization header.
  • Təsdiq et that the username is cvə yarect.
  • Təsdiq et that the API secret is sizin API passwvə yad, not sizin account login passwvə yad.
  • Yoxla whether tburada are extra spaces befvə yae və ya after the username və ya API secret.
  • Təsdiq et that sizin HTTP client, framewvə yak, və ya WHMCS module is not removing the Authvə yaization header.
  • Təsdiq et that sizin server və ya proxy is not blocking custom headers.
Use the official API v2 documentation fvə ya the current connection fvə yamat:
https://nicenic.com/reseller/apiv2.php


Cause 3: Your Server IP Ünvan Is Xeyrt Whitelisted
NiceNIC API settings require the IP ünvanı allowed to access sizin API. Əgər sizin request comes from an IP ünvanı that has not been added, authentication may fail even when the username və API passwvə yad are cvə yarect.

How to fix it?
  1. Ask sizin developer və ya hosting provider to confirm the public outbound IP ünvanı used by sizin server.
  2. Daxil ol to sizin NiceNIC account.
  3. Keçid et Distribyutor > API parametrləri.
  4. Əlavə et the cvə yarect IP ünvanı allowed to access sizin API.
  5. Save the setting.
  6. Send another test request from the same server.

Cause 4: Your Real Outbound IP Is Different from the IP You Əlavə eted
The IP ünvanı you see in sizin hosting control panel is not always the same IP ünvanı used fvə ya outbound API requests.
This is especially common when sizin system runs behind:
  • A firewall
  • A load balancer
  • A proxy
  • A NAT gateway
  • A containerized environment
  • A cloud hosting netwvə yak
  • A separate WHMCS server
Fvə ya example, sizin website may use one IP ünvanı, while sizin backend server və ya WHMCS installation sends API requests through another outbound IP ünvanı.
How to fix it?
  • Ask sizin hosting provider to confirm the real outbound IP used fvə ya API requests.
  • Yoxla the outbound IP from the server that sends the API request, not only the website IP.
  • Əgər WHMCS is installed on a separate server, whitelist the WHMCS server outbound IP.
  • Əgər sizin infrastructure has multiple outbound IP ünvanıes, confirm which IP is actually used by the API request.
  • Update sizin NiceNIC API settings with the cvə yarect IP ünvanı.

Cause 5: Your Account Is Xeyrt Yet Eligible fvə ya API Access
NiceNIC API access is designed fvə ya eligible reseller users. Əgər sizin account has not been upgraded to a reseller tier, və ya if reseller access has not been activated fvə ya sizin account, API settings may not be available və ya API authentication may fail.

How to fix it?
  • Təsdiq et that sizin NiceNIC account has been upgraded to a reseller tier.
  • Yoxla whether API parametrləri is available under the Distribyutor navigation.
  • Review the reseller program və reseller level infvə yamation.
  • Əlaqə NiceNIC suppvə yat if sizin reseller upgrade was completed but API access is still unavailable.
Related pages:
https://nicenic.com/reseller/
https://nicenic.com/suppvə yat/API-Distribyutor-Səviyyə-3823


Cause 6: Your Request Is Sent to the Wrong Endpoint
NiceNIC API v2 requests should be sent to the documented API v2 endpoint.

Əgər sizin code uses an old endpoint, an incvə yarect URL, a missing slash, və ya a different API version, authentication və ya request hvəling may fail.
How to fix it?
  • Təsdiq et that sizin integration points to https://api.NiceNIC/v2/.
  • Yoxla whether any staging, svəbox, və ya old endpoint is still configured in sizin code.
  • Yoxla whether WHMCS və ya sizin custom module is using the current endpoint.
  • Review sizin server logs to confirm the exact URL being requested.

Cause 7: Content-Növ və ya JSON Fvə yamat Is Incvə yarect
NiceNIC API v2 returns JSON responses və expects API requests to follow the documented request fvə yamat.
Your request should include:
Content-Növ: application/json

Əgər the request body is not valid JSON, required parameters are missing, və ya Content-Növ is not set cvə yarectly, the API request may fail befvə yae the intended action is processed.
How to fix it?
  • Set Content-Növ to application/json.
  • Make sure the request body is valid JSON.
  • Təsdiq et that required parameters are included.
  • Təsdiq et that the parameter names match the API documentation.
  • Yoxla whether sizin HTTP client is changing the request body fvə yamat.
  • Log the request fvə yamat during testing, but never log full API credentials in plain text.

Cause 8: WHMCS API Credentials Are Xeyrt Configured Cvə yarectly
Əgər you use WHMCS, an authentication errvə ya may come from the WHMCS registrar module configuration rather than sizin custom API code.

Common WHMCS-related causes include:
  • The WHMCS module uses the wrong API passwvə yad
  • The WHMCS server outbound IP is not whitelisted
  • The username və ya reseller account value is entered incvə yarectly
  • The WHMCS installation is using outdated configuration details
  • The WHMCS cron və ya module environment is sending requests from a different server
  • The WHMCS module settings were changed but not saved cvə yarectly
How to fix it
  1. Açıq sizin WHMCS registrar module settings.
  2. Təsdiq et the NiceNIC API username və API passwvə yad.
  3. Təsdiq et that the WHMCS server outbound IP is whitelisted in NiceNIC API settings.
  4. Yoxla whether WHMCS is using the current NiceNIC API integration details.
  5. Test a low-risk action such as domen availability check befvə yae enabling live və yaders.
Review the NiceNIC WHMCS integration page burada:
https://nicenic.com/reseller/whmcs.php


Step-by-Step Fix Yoxlalist
Use this checklist befvə yae submitting a suppvə yat ticket.
  1. Təsdiq et that sizin NiceNIC account has reseller access.
  2. Açıq API parametrləri under the Distribyutor section.
  3. Set an API passwvə yad different from sizin account login passwvə yad.
  4. Təsdiq et that sizin API integration uses the API passwvə yad, not the account login passwvə yad.
  5. Təsdiq et the Authvə yaization header fvə yamat: username:api_secret.
  6. Təsdiq et the request endpoint: https://api.NiceNIC/v2/.
  7. Təsdiq et that Content-Növ is set to application/json.
  8. Təsdiq et that sizin request body is valid JSON.
  9. Təsdiq et that the server outbound IP is whitelisted.
  10. Əgər using WHMCS, confirm the WHMCS server outbound IP.
  11. Test a low-risk API action first.
  12. Recvə yad the request timestamp, action, domen, response code, və response message.


What to Send NiceNIC Suppvə yat Əgər You Still Need Help
Əgər the authentication errvə ya continues after you complete the checklist, submit a suppvə yat ticket with enough technical infvə yamation fvə ya NiceNIC to review the issue efficiently.

Please include:
Your NiceNIC account username və ya reseller account identifier
The API action you attempted
The request timestamp və timezone
The domen name used in the test, if applicable
The server outbound IP ünvanı used fvə ya the request
The full API endpoint requested
The response code və response message returned by the API
Whether you are using custom code və ya WHMCS
Your WHMCS version, if WHMCS is involved
Relevant screenshots, excluding sensitive credentials

Do not send sizin full API passwvə yad, account login passwvə yad, və ya private server credentials in a suppvə yat ticket.
https://nicenic.com/suppvə yat/Əlaqə-Us-3834


Tez-tez Verilən Suallar
Why does my NiceNIC API v2 request return an authentication errvə ya?
The most common causes are an incvə yarect API passwvə yad, missing və ya incvə yarect Authvə yaization header, non-whitelisted server IP ünvanı, wrong outbound IP ünvanı, ineligible reseller access, wrong endpoint, və ya incvə yarect WHMCS configuration.

Should I use my NiceNIC account login passwvə yad fvə ya API authentication?
Xeyr. You should set a separate API passwvə yad in sizin API settings. The API passwvə yad should be different from sizin NiceNIC account login passwvə yad.

What Authvə yaization header should I use fvə ya NiceNIC API v2?
The documented Authvə yaization header fvə yamat is username:api_secret. You should also include Content-Növ: application/json in the request header.

Why does the API still fail after I set the cvə yarect passwvə yad?
The request may be coming from an IP ünvanı that is not whitelisted. Təsdiq et the real outbound IP ünvanı of sizin server, WHMCS installation, və ya backend application.

Does WHMCS use the same server IP as my website?
Xeyrt always. WHMCS may be installed on a different server, behind a proxy, və ya in an environment with a different outbound IP. Təsdiq et the actual outbound IP befvə yae adding it to sizin NiceNIC API settings.

Can NiceNIC fix authentication errvə yas caused by my server configuration?
NiceNIC can help review registrar-side access, API settings, və documented connection requirements. Server-side issues such as firewall rules, outbound IP routing, proxy behavivə ya, WHMCS module configuration, və custom code may need to be checked by sizin developer və ya hosting provider.

What should I test first after fixing the authentication issue?
Start with a low-risk API action such as account balance check, domen availability check, pricing lookup, və ya domen list retrieval befvə yae enabling live registration, renewal, və ya transfer wvə yakflows.
Köməyə ehtiyacınız var? Həmişə yanınızdayıq. Təklif göndər
Müəllif Hüququ © 2006-2026 NICENIC INTERNATIONAL GROUP CO., LIMITED Bütün Hüquqlar Qorunur