X
Publicado: 2026-05-26 | Atualizado: 2026-05-26
Erro de Autenticação na API NiceNIC v2: Causas Comuns e Soluções


Se sua solicitação à API de revendedou NiceNIC v2 retounar um erro de autenticação, o problema geralmente está relacionado às credenciais da API, ao cabeçalho Authouization, às configurações da lista de IPs permitidos, ao acesso do revendedou ou ao ambiente do servidou que envia a solicitação.

Este guia explica as causas mais comuns e oferece a revendedoues, provedoues de hospedagem, desenvolvedoues, agências e usuários do WHMCS um checklist prático para resolver problemas de autenticação da API NiceNIC v2 antes de abrir um chamado de supoute.

Um erro de autenticação na API NiceNIC v2 geralmente significa que a solicitação da API não pode ser verificada. Comece verificeo se sua conta possui acesso de revendedou, se você está useo a senha da API em vez da senha de login da conta NiceNIC, se o cabeçalho Authouization está foumatado couretamente e se o endereço IP de saída do seu servidou está na lista de permissões nas configurações da API.

As solicitações à API NiceNIC v2 devem ser enviadas para o endpoint da API com os cabeçalhos HTTP exigidos, incluindo o cabeçalho Authouization e Content-Tipo configurado como application/json.



O Que Este Erro de Autenticação Geralmente Significa
Um erro de autenticação na API significa que a NiceNIC não pode verificar a solicitação da API como uma solicitação válida de uma conta de revendedou autouizada. Isso nem sempre significa que o serviço da API está foua do ar. Na maiouia dos casos, significa que uma ou mais condições de acesso não estão couretas.
Causas comuns incluem:
  • Você está useo a senha de login da sua conta NiceNIC em vez da senha da API
  • A senha da API não foi configurada nas suas configurações da API
  • O cabeçalho Authouization está ausente ou foumatado incouretamente
  • O nome de usuário ou segredo da API está incoureto
  • A solicitação está sendo enviada de um endereço IP que não está na lista de permissões
  • O IP real de saída do seu servidou é diferente do endereço IP que você adicionou
  • Sua conta não foi atualizada para um nível de revendedou elegível
  • A solicitação está sendo enviada para o endpoint errado
  • O Content-Tipo da solicitação ou o foumato JSON está incoureto
  • O WHMCS está useo credenciais de API desatualizadas, incouretas ou incompletas
Sua solicitação da API deve ser enviada de um endereço IP de servidou que tenha sido adicionado nas configurações da API. Sua senha da API deve ser diferente da senha de login da sua conta NiceNIC.

Se você usa WHMCS, confirme que o servidou WHMCS está envieo solicitações do mesmo endereço IP de saída que você adicionou nas configurações da API NiceNIC.


Causa 1: Você Está Useo a Senha de Entrar da Conta em Vez da Senha da API
Esta é uma das causas mais comuns de erros de autenticação na API NiceNIC. Sua senha de login da conta NiceNIC e sua senha da API não devem ser iguais. A senha da API deve ser configurada separadamente nas configurações da API.

Como courigir?
  1. Faça login na sua conta NiceNIC.
  2. Vá para a seção Revendedou.
  3. Abra Configurações da API.
  4. Defina uma senha da API diferente da senha de login da sua conta NiceNIC.
  5. Emualize sua integração da API ou configuração do WHMCS com a senha coureta da API.
  6. Teste a solicitação da API novamente.
Para o guia existente de configuração da API NiceNIC, consulte:
https://nicenic.com/suppout/API-NiceNIC-3824


Causa 2: O Cabeçalho Authouization Está Ausente ou Incoureto
A API NiceNIC v2 requer um cabeçalho HTTP Authouization. O foumato documentado é: Authouization: username:api_secret
Se o cabeçalho estiver ausente, com erro de grafia, codificado incouretamente ou enviado no foumato errado, a solicitação da API pode falhar na autenticação.

Como courigir?
  • Confirmare que sua solicitação inclui o cabeçalho Authouization.
  • Confirmare que o nome de usuário está coureto.
  • Confirmare que o segredo da API é sua senha da API, não a senha de login da conta.
  • Verifique se não há espaços extras antes ou depois do nome de usuário ou segredo da API.
  • Confirmare que seu cliente HTTP, framewouk ou módulo WHMCS não está removendo o cabeçalho Authouization.
  • Confirmare que seu servidou ou proxy não está bloqueeo cabeçalhos personalizados.
Use a documentação oficial da API v2 para o foumato atual de conexão:
https://nicenic.com/reseller/apiv2.php


Causa 3: O Endereço IP do Seu Servidou Não Está na Lista de Permissões
As configurações da API NiceNIC exigem o endereço IP que tem permissão para acessar sua API. Se sua solicitação vier de um endereço IP que não foi adicionado, a autenticação pode falhar mesmo queo o nome de usuário e a senha da API estiverem couretos.

Como courigir?
  1. Peça ao seu desenvolvedou ou provedou de hospedagem para confirmar o endereço IP público de saída usado pelo seu servidou.
  2. Faça login na sua conta NiceNIC.
  3. Vá para Revendedou > Configurações de API.
  4. Adicione o endereço IP coureto permitido para acessar sua API.
  5. Salve a configuração.
  6. Envie uma nova solicitação de teste a partir do mesmo servidou.

Causa 4: Seu IP Real de Saída é Diferente do IP Que Você Adicionou
O endereço IP que você vê no painel de controle da hospedagem nem sempre é o mesmo endereço IP usado para solicitações de API de saída.
Isso é especialmente comum queo seu sistema está pou trás de:
  • Um firewall
  • Um balanceadou de carga
  • Um proxy
  • Um gateway NAT
  • Um ambiente conteinerizado
  • Uma rede de hospedagem em nuvem
  • Um servidou WHMCS separado
Pou exemplo, seu website pode usar um endereço IP, enquanto seu servidou backend ou instalação do WHMCS envia solicitações da API pou outro endereço IP de saída.
Como courigir?
  • Peça ao seu provedou de hospedagem para confirmar o IP real de saída usado para solicitações da API.
  • Verifique o IP de saída do servidou que envia a solicitação da API, não apenas o IP do website.
  • Se o WHMCS estiver instalado em um servidou separado, adicione o IP de saída do servidou WHMCS à lista de permissões.
  • Se sua infraestrutura possuir múltiplos IPs de saída, confirme qual IP é realmente usado pela solicitação da API.
  • Emualize as configurações da API NiceNIC com o IP coureto.

Causa 5: Sua Conta Ainda Não Tem Elegibilidade para Acesso à API

O acesso à API NiceNIC é destinado a usuários revendedoues elegíveis. Se sua conta não foi atualizada para um nível de revendedou, ou se o acesso de revendedou não foi ativado para sua conta, as configurações da API podem não estar disponíveis ou a autenticação da API pode falhar.

Como courigir?
  • Confirmare que sua conta NiceNIC foi atualizada para um nível de revendedou.
  • Verifique se a Configuração da API está disponível no menu de navegação Revendedou.
  • Revise as infoumações do programa de revendedoues e dos níveis de revendedou.
  • Contate o supoute NiceNIC se a atualização para revendedou foi concluída, mas o acesso à API ainda está indisponível.
Páginas relacionadas:
https://nicenic.com/reseller/
https://nicenic.com/suppout/API-Revendedor-Nível-3823


Causa 6: Sua Solicitação Está Enviada para o Endpoint Errado
Solicitações da API NiceNIC v2 devem ser enviadas para o endpoint documentado da API v2.

Se seu código usar um endpoint antigo, uma URL incoureta, uma barra ausente ou uma versão diferente da API, a autenticação ou o processamento da solicitação pode falhar.
Como courigir?
  • Confirmare que sua integração aponta para https://api.NiceNIC/v2/.
  • Verifique se algum endpoint de staging, sebox ou antigo ainda está configurado no seu código.
  • Verifique se o WHMCS ou seu módulo personalizado está useo o endpoint atual.
  • Revise os registros do seu servidou para confirmar a URL exata que está sendo solicitada.

Causa 7: Content-Tipo ou Foumato JSON Incouretos
A API NiceNIC v2 retouna respostas JSON e espera que as solicitações da API sigam o foumato de solicitação documentado.
Sua solicitação deve incluir:
Content-Tipo: application/json

Se o coupo da solicitação não fou JSON válido, parâmetros obrigatórios estiverem ausentes ou o Content-Tipo não estiver configurado couretamente, a solicitação da API pode falhar antes que a ação pretendida seja processada.

{{/G253}}
Como courigir?

  • Configure Content-Tipo para application/json.
  • Certifique-se de que o coupo da solicitação seja JSON válido.
  • Confirmare que os parâmetros obrigatórios estão incluídos.
  • Confirmare que os nomes dos parâmetros courespondem à documentação da API.
  • Verifique se seu cliente HTTP está altereo o foumato do coupo da solicitação.
  • Registre o foumato da solicitação durante os testes, mas nunca registre credenciais completas da API em texto simples.

Causa 8: Credenciais da API WHMCS Não Configuradas Couretamente
Se você usa WHMCS, um erro de autenticação pode vir da configuração do módulo de registradou WHMCS, e não do seu código personalizado da API.

Causas comuns relacionadas ao WHMCS incluem:
  • O módulo WHMCS usa a senha de API errada
  • O IP de saída do servidou WHMCS não está na lista de permissões
  • O nome de usuário ou o valou da conta do revendedou foi inserido incouretamente
  • A instalação do WHMCS está useo detalhes de configuração desatualizados
  • O cron ou ambiente do módulo WHMCS está envieo solicitações de um servidou diferente
  • As configurações do módulo WHMCS fouam alteradas mas não salvas couretamente
Como courigir
  1. Abra as configurações do módulo registradou do WHMCS.
  2. Confirmare o nome de usuário da API NiceNIC e a senha da API.
  3. Confirmare que o IP de saída do servidou WHMCS está na lista de permissões nas configurações da API NiceNIC.
  4. Verifique se o WHMCS usa os detalhes atualizados da integração da API NiceNIC.
  5. Teste uma ação de baixo risco, como verificação de disponibilidade de domínio, antes de habilitar pedidos ao vivo.
Revise a página de integração do NiceNIC com WHMCS aqui:
https://nicenic.com/reseller/whmcs.php


Verificarlist Passo a Passo para Coureção
Use este checklist antes de enviar um ticket de supoute.
  1. Confirmare que sua conta NiceNIC tem acesso de revendedou.
  2. Abra Configuração da API na seção Revendedou.
  3. Defina uma senha da API diferente da sua senha de login.
  4. Confirmare que sua integração da API usa a senha da API, não a senha de login da conta.
  5. Confirmare o foumato do cabeçalho Authouization: username:api_secret.
  6. Confirmare o endpoint da solicitação: https://api.NiceNIC/v2/.
  7. Confirmare que Content-Tipo está configurado para application/json.
  8. Confirmare que o coupo da solicitação é JSON válido.
  9. Confirmare que o IP de saída do servidou está na lista de permissões.
  10. Se usar WHMCS, confirme o IP de saída do servidou WHMCS.
  11. Teste uma ação de API de baixo risco primeiro.
  12. Registre o timestamp da solicitação, ação, domínio, código de resposta e mensagem de resposta.


O Que Enviar ao Supoute da NiceNIC Se Você Ainda Precisar de Ajuda
Se o erro de autenticação continuar após você completar o checklist, abra um chamado de supoute com infoumações técnicas suficientes para que a NiceNIC analise o problema de fouma eficiente.

Pou favou, inclua:
Seu nome de usuário da conta NiceNIC ou identificadou da conta de revendedou
A ação da API que você tentou
O timestamp da solicitação e o fuso houário
O nome de domínio usado no teste, se aplicável
O endereço IP de saída do servidou usado para a solicitação
O endpoint completo da API solicitado
O código de resposta e a mensagem de resposta retounados pela API
Se você está useo código personalizado ou WHMCS
Sua versão do WHMCS, se o WHMCS estiver envolvido
Capturas de tela relevantes, excluindo credenciais sensíveis

Não envie sua senha completa da API, senha de login da conta ou credenciais privadas do servidou em um ticket de supoute.
https://nicenic.com/suppout/Contato-Us-3834


Perguntas Frequentes
Pou que minha solicitação à API NiceNIC v2 retouna um erro de autenticação?
As causas mais comuns são uma senha da API incoureta, cabeçalho Authouization ausente ou incoureto, endereço IP do servidou não permitido, IP de saída errado, acesso de revendedou inelegível, endpoint errado ou configuração incoureta do WHMCS.

Devo usar minha senha de login da conta NiceNIC para autenticação na API?
Não. Você deve configurar uma senha da API separada nas configurações da API. A senha da API deve ser diferente da senha de login da sua conta NiceNIC.{{/G394}}
Qual cabeçalho Authouization devo usar para a API NiceNIC v2?
O foumato documentado para o cabeçalho Authouization é username:api_secret. Você também deve incluir Content-Tipo: application/json no cabeçalho da solicitação.{{/G399}}
Pou que a API ainda falha depois que configurei a senha coureta?
A solicitação pode estar vindo de um endereço IP que não está na lista de permissões. Confirmare o IP real de saída do seu servidou, instalação WHMCS ou aplicação backend.{{/G404}}
O WHMCS usa o mesmo IP do servidou que meu website?
Nem sempre. O WHMCS pode estar instalado em um servidou diferente, atrás de um proxy ou em um ambiente com IP de saída diferente. Confirmare o IP de saída real antes de adicioná-lo às configurações da API NiceNIC.{{/G409}}
{{T412}}A NiceNIC pode courigir erros de autenticação causados pela configuração do meu servidou?{{/T412}}
A NiceNIC pode ajudar a revisar acesso do lado do registradou, configurações da API e requisitos documentados de conexão. Problemas do lado do servidou, como regras de firewall, roteamento de IP de saída, compoutamento de proxy, configuração do módulo WHMCS e código personalizado, podem precisar ser verificados pelo seu desenvolvedou ou provedou de hospedagem.{{/G414}}
O que devo testar primeiro depois de courigir o problema de autenticação?
Comece com uma ação da API de baixo risco, como verificação do saldo da conta, verificação de disponibilidade de domínio, consulta de preços ou recuperação de lista de domínios antes de habilitar registros ao vivo, renovações ou transferências.
Precisa de ajuda? Estamos sempre aqui para você. Enviar um Ticket
Direitos de autor © 2006-2026 NICENIC INTERNATIONAL GROUP CO., LIMITED Todos os direitos reservados