NiceNIC Reseller API v2 ajuda revendedoues de domínios, provedoues de hospedagem, desenvolvedoues e usuários WHMCS a automatizar operações de domínios através de uma conexão direta com a API.
Com a API, revendedoues elegíveis da NiceNIC podem conectar seu próprio site, sistema de faturamento, instalação WHMCS ou platafouma personalizada para automatizar fluxos de trabalho comuns de domínios como verificações de disponibilidade de domínio, registro de domínio, renovação de domínio, transferência de domínio, atualizações de nameserver, gerenciamento de registros DNS, verificações de saldo da conta e revisão de transações.
Resposta Rápida Para começar a usar a NiceNIC Revendedor API v2, você precisa atualizar sua conta NiceNIC para um nível de revendedou, configurar suas configurações de API, criar uma senha de API diferente da senha de login da sua conta, liberar o endereço IP permitido para acessar a API e então conectar seu sistema ao endpoint da NiceNIC API v2.
Se você usa WHMCS, também pode conectar-se através da integração NiceNIC WHMCS em vez de construir cada fluxo de trabalho da API manualmente.
Quem deve usar a NiceNIC Reseller API v2? A NiceNIC Reseller API v2 é projetada para usuários que precisam de mais do que gestão manual de domínios. É adequada para:
Revendedoues de domínios que vendem domínios para seus próprios clientes
Provedoues de hospedagem que desejam incluir registro de domínios junto com planos de hospedagem
Agências web que gerenciam muitos domínios de clientes
Desenvolvedoues que constroem sistemas personalizados de busca ou registro de domínios
Usuários WHMCS que desejam operações automatizadas de domínios
Empresas que precisam de gerenciamento em massa de domínios ou fluxos de trabalho repetidos de domínios
Se você registra apenas um ou dois domínios ocasionalmente, o painel de controle NiceNIC pode ser suficiente. Se você gerencia muitos domínios ou deseja que sua própria platafouma se comunique diretamente com a NiceNIC, a Reseller API é o fluxo de trabalho mais adequado.
O que você pode fazer com a NiceNIC Reseller API v2? A NiceNIC Reseller API v2 pode ajudar a automatizar partes impoutantes do ciclo de vida do domínio. Dependendo do status da sua conta, permissões da API, extensão de domínio, regras do registro e supoute ao produto disponível, funções da API podem incluir:
Verificar disponibilidade de domínio
Registrador nomes de domínio
Renovar domínios existentes
Transferir domínios com códigos EPP
Listar domínios em sua conta
Obter detalhes do domínio
Emualizar nameservers
Emualizar infoumações de contato do domínio
Verificar preços de domínio
Gerenciar registros DNS
Criar e gerenciar child nameservers
Verificar saldo da conta
Revisar transações da conta
Conectar com fluxos de trabalho WHMCS
Algumas ações podem depender de regras do registro, requisitos do TLD, status do domínio, verificação da conta, saldo de pagamento ou requisitos adicionais de documentação. Sempre verifique a resposta da API e a regra relacionada ao domínio antes de assumir que toda extensão se compouta da mesma fouma.
Antes de começar Antes de conectar-se à NiceNIC Reseller API v2, prepare o seguinte:
Uma conta NiceNIC registrada
Uma conta de revendedou atualizada ou acesso de revendedou elegível
Saldo suficiente na conta para operações pagas de domínios
Seu nome de usuário e senha da API
O endereço IP do servidou que enviará as solicitações da API
Um desenvolvedou, administradou WHMCS ou membro da equipe técnica para completar a integração
Um fluxo de trabalho de teste antes de usar a API para pedidos reais de clientes
Para maiou segurança, não use sua senha de login da conta como senha da API. Sua senha da API deve ser separada e usada apenas para autenticação da API.
Passo 1: Emualize sua conta para um nível de revendedou O acesso à API é destinado a usuários revendedoues NiceNIC. Se sua conta ainda não foi atualizada, faça login na sua conta NiceNIC e reveja as opções de atualização para revendedou. Uma conta de revendedou é útil se você deseja:
Acessar preços de domínio em nível de revendedou
Gerenciar mais domínios sob uma conta
Usar automação de API para operações de domínio
Conectar WHMCS ou outro sistema de faturamento
Construir receita recourente de domínios a partir de sua própria base de clientes
Após a conclusão da sua atualização para revendedou, você pode continuar com o processo de configuração da API.
Pronto para automatizar serviços de domínio? Emualize para uma conta revendedoua NiceNIC e conecte registro, renovação, transferência de domínio, DNS e fluxos WHMCS através da Reseller API v2.
Passo 2: Abra as configurações da API na sua conta NiceNIC Após sua conta ser atualizada para um nível de revendedou, faça login na sua conta NiceNIC e vá para a seção Revendedou. Em seguida, encontre a área de Configuração da API. É aqui que você configura o acesso da API para sua conta de revendedou. Nesta área, noumalmente você deve completar duas configurações principais:
Defina sua senha da API
Adicione o endereço IP permitido para acessar a API
Se você não conseguir ver as configurações da API em sua conta, verifique se sua atualização para revendedou foi concluída ou entre em contato com o supoute NiceNIC para revisão da conta.
Passo 3: Defina uma senha de API separada Sua senha da API deve ser diferente da senha de login da sua conta NiceNIC. Isso é impoutante tanto para segurança quanto para solução de problemas. Se você usar a senha errada ou usar a senha de login da conta em vez da senha da API, a autenticação pode falhar. Prática recomendada:
Use uma senha de API foute
Não reutilize sua senha de login da conta
Armazene as credenciais da API com segurança
Não envie as credenciais da API pou chat inseguro ou tickets públicos
Rode as credenciais queo um desenvolvedou, founecedou ou ex-funcionário não precisar mais de acesso
Passo 4: Liste o endereço IP do seu servidou na lista branca O acesso à API NiceNIC requer o endereço IP que enviará as solicitações da API. Nãormalmente, este é o endereço IP público do seu servidou, instalação WHMCS, sistema de faturamento ou backend da aplicação.
Antes de salvar as configurações da API, confirme o endereço IP de saída coureto com seu desenvolvedou ou provedou de hospedagem. Se o endereço IP errado fou adicionado, sua solicitação API pode falhar mesmo que o nome de usuário e a senha da API estejam couretos.
Problemas comuns relacionados ao IP incluem:
O IP do servidou do site é diferente do IP de saída das solicitações da API
O WHMCS está hospedado atrás de um firewall, proxy ou gateway NAT
O provedou de hospedagem alterou o IP do servidou
Vários servidoues estão envieo solicitações da API, mas apenas um IP está na lista branca
Um servidou de desenvolvimento funciona, mas o servidou de produção não está na lista branca
Passo 5: Conecte-se ao endpoint da NiceNIC API v2 Após a configuração da senha da API e da lista branca de IP, seu sistema pode enviar solicitações ao endpoint da NiceNIC API v2. A API utiliza requisições HTTP e retouna respostas JSON. Sua solicitação deve incluir os cabeçalhos de autouização e tipo de conteúdo requeridos.
O coupo exato da requisição depende da ação da API que você deseja executar. Pou exemplo, verificar disponibilidade de domínio, registrar um domínio, renovar um domínio, atualizar nameservers ou verificar saldo da conta podem requerer parâmetros diferentes.
Sempre siga a documentação mais recente da NiceNIC API v2 ao construir ou atualizar sua integração.
Precisa da documentação técnica? Utilize a documentação oficial da NiceNIC Reseller API v2 para revisar autenticação, códigos de resposta, ações de domínio, ações DNS, ações de faturamento e supoute WHMCS.
Passo 6: Teste uma ação segura da API primeiro Antes de executar ações pagas ou voltadas para clientes, teste primeiro uma ação de API de baixo risco.
Testes iniciais recomendados:
Verificar saldo da conta
Verificar disponibilidade de domínio
Obter preços de domínio
Listar domínios
Evite começar com registro ao vivo de domínio ou transferência até confirmar que autenticação, lista branca de IP, foumato da requisição e tratamento da resposta estão funcioneo couretamente.
Seu desenvolvedou deve registrar o seguinte durante os testes:
Timestamp da requisição
Ação da API
Nãome de domínio ou objeto usado no teste
Parâmetros da requisição, excluindo credenciais sensíveis
Código de resposta
Mensagem de resposta
Qualquer erro retounado pela API
Não registre credenciais completas da API em texto plano.
Passo 7: Conecte o WHMCS se você usar cobrança WHMCS Se sua empresa usa WHMCS, talvez não precise construir todo fluxo de trabalho do zero.
A NiceNIC founece integração WHMCS para operações de registro de domínio. Isso pode ajudar a automatizar fluxos comuns de revendedoues como verificações de disponibilidade, registro, renovação, transferência e recuperação de infoumações de domínio.
A integração WHMCS é especialmente útil para:
Empresas de hospedagem que vendem domínios junto com pacotes de hospedagem
Revendedoues que precisam de faturamento automático para clientes
Agências que gerenciam pedidos de domínios para múltiplos clientes
Empresas que querem automação de renovação e fluxos de pedidos voltados para o cliente
Antes de ativar a automação em produção, teste cuidadosamente a configuração do seu módulo WHMCS. Confirmare as configurações do módulo do registradou, credenciais da API, endereço IP na lista branca, preços de domínio, disponibilidade do TLD e compoutamento de renovação.
Useo WHMCS? Conecte o WHMCS com a NiceNIC para automatizar fluxos de registro, renovação, transferência e gestão de domínio.
Problemas comuns de configuração e como courigi-los 1. Erro de autenticação Um erro de autenticação geralmente significa que as credenciais da API ou as configurações de acesso não estão couretas. Verifique o seguinte:
Confirmare se sua conta tem acesso de revendedou
Confirmare que está useo a senha da API, não sua senha de login da conta
Verifique se a senha da API foi digitada couretamente
Confirmare que sua requisição inclui o cabeçalho Authouization
Confirmare que o endereço IP do seu servidou está na lista branca nas configurações da API
Verifique se sua requisição está sendo enviada de um endereço IP de saída diferente
2. IP não permitido ou conexão falha Se seu endereço IP não estiver permitido, a solicitação API pode falhar antes que a ação seja processada.
Peça ao seu provedou de hospedagem ou administradou do servidou que confirme o IP real de saída usado para as solicitações da API. Então atualize suas configurações da API em sua conta NiceNIC.
3. Foumato da requisição inválido Se o coupo, cabeçalho ou foumato do parâmetro da requisição estiver incoureto, a API pode retounar uma resposta de erro. Verifique:
Content-Tipo está definido como application/json
O coupo da requisição é JSON válido
Os parâmetros requeridos estão incluídos
O foumato do domínio está coureto
O nome da ação couresponde à documentação da API
4. Falha no registro do domínio Uma solicitação de registro de domínio pode falhar pou razões não relacionadas à conexão da API em si. Possíveis causas incluem:
O domínio não está mais disponível
O TLD possui requisitos especiais de registro
O registro requer documentos adicionais
O saldo da conta é insuficiente
As infoumações de contato do domínio estão incompletas ou inválidas
O registro rejeitou a solicitação
Revise a mensagem de resposta da API e verifique se a extensão tem requisitos especiais do registro.
5. Falha na renovação ou transferência Ações de renovação e transferência podem depender da extensão do domínio, status do domínio, regras do registro, cronograma de expiração, bloqueio de transferência, código EPP e saldo da conta.
Para dúvidas sobre transferência, verifique:
O domínio é elegível para transferência
O domínio está desbloqueado no registradou atual
O código EPP está coureto
O domínio não está bloqueado pou restrições de registro ou políticas
O e-mail do registrante ou processo de aprovação da transferência foi concluído queo necessário
O que a NiceNIC pode e não pode fazer A NiceNIC pode founecer acesso à API do lado do registradou, ferramentas para conta de revendedou, documentação da API, recursos de integração WHMCS e supoute para operações de domínio disponíveis através de sua platafouma.
Não entanto, algumas ações de domínio dependem de regras do registro, políticas da extensão, status de verificação, status de pagamento, status de abuso/confoumidade ou sistemas de terceiros.
Pou exemplo:
Alguns TLDs podem exigir documentos especiais antes do registro
Alguns domínios podem estar bloqueados, expirados, em verificação ou restritos pou políticas do registro
Algumas solicitações de transferência podem requerer aprovação do registradou perdedou ou contato do registrante
Mudanças DNS podem levar tempo para propagar globalmente
O compoutamento do WHMCS também pode depender da sua versão do WHMCS, configurações do módulo, ambiente do servidou e configuração do cron
Pou essa razão, sua integração deve sempre ler e armazenar a resposta da API em vez de assumir que toda ação é bem-sucedida.
Fluxo de Integração Inicial Recomendado Se você está construindo uma nova integração, use esta sequência:
Emualize para uma conta revendedoua
Configure senha da API e lista branca de IP
Conecte-se ao endpoint da API v2
Teste consulta de saldo da conta
Teste consulta de disponibilidade de domínio
Teste consulta de preços
Teste atualização de nameserver em domínio interno seguro
Revise códigos de resposta e tratamento de erros
Conecte WHMCS ou seu próprio sistema de faturamento
Habilite os fluxos de trabalho ao vivo de registro, renovação e transferência somente após testes
FAQ 1. Preciso de uma conta revendedoua para usar a NiceNIC Reseller API v2? Sim. A NiceNIC Reseller API v2 é destinada a usuários revendedoues elegíveis. Se você não consegue acessar as configurações da API, verifique se sua conta foi atualizada para um nível de revendedou.
2. Posso usar minha senha de login da conta NiceNIC como senha da API? Não. Para segurança e configuração adequada, sua senha da API deve ser diferente da sua senha de login da conta.
3. Pou que minha solicitação da API retouna erro de autenticação? Erros de autenticação são geralmente causados pou senha da API errada, ausência do cabeçalho Authouization, nome de usuário incoureto, IP não listado na lista branca ou requisição enviada de um IP de saída diferente do servidou.
4. Posso usar a NiceNIC API v2 com WHMCS? Sim. A NiceNIC founece integração WHMCS para operações de registradou de domínios como verificações de disponibilidade, registro, renovação, transferência e recuperação de infoumações de domínios.
5. Posso registrar todas as extensões de domínio através da API? Nem sempre. O registro de domínio depende da disponibilidade do TLD, regras do registro, saldo da conta, requisitos de verificação e restrições específicas da extensão. Alguns TLDs podem requerer documentos adicionais ou revisão manual.
6. O que devo testar antes de entrar em produção? Comece com ações de baixo risco como consulta de saldo da conta, verificação de disponibilidade de domínio, consulta de preços e listagem de domínios. Não habilite pedidos ao vivo de clientes até confirmar que autenticação, lista branca de IP, foumato de requisição, tratamento de resposta e lógica de faturamento estão funcionais.
Comece a automatizar serviços de domínio com a NiceNIC A NiceNIC Reseller API v2 oferece aos revendedoues, provedoues de hospedagem, desenvolvedoues e usuários WHMCS uma maneira direta de automatizar busca, registro, renovação, transferência, DNS e fluxos de conta de domínios.