Skip to content

README.md

Latest commit

 

History

History
122 lines (90 loc) · 3.94 KB

README.md

File metadata and controls

122 lines (90 loc) · 3.94 KB
Raw

Consulta WHOIS

Bem-vindo à documentação do projeto Consulta WHOIS, hospedado no GitHub pelo usuário Skylinenando. Este projeto permite consultar informações detalhadas de WHOIS sobre domínios ou IPs, utilizando a API JSONWhois.

Índice

  1. Instalação
  2. Configuração da API
  3. Como o Código Funciona
  4. Informações Retornadas
  5. Execução do Projeto

Instalação

Pré-requisitos

Para executar o projeto, você precisa:

  • PHP 7.4+
  • Composer (para gerenciar dependências)
  • Servidor Web (Apache, Nginx, etc.)
  • Conexão com a Internet (para acessar a API JSONWhois)

Passos para Instalação

  1. Clone o repositório

    git clone https://github.com/Skylinenando/consulta-whois.git
cd consulta-whois

  2. Instale as dependências Use o Composer para instalar a biblioteca Unirest:

    composer require mashape/unirest-php

  3. Configure as permissões Garanta que o diretório do projeto tenha permissões adequadas:

    chmod -R 755 consulta-whois

  4. Suba o servidor local Em um ambiente de desenvolvimento, utilize o servidor embutido do PHP:

    php -S localhost:8000

Configuração da API

Este projeto utiliza a API JSONWhois para consultar informações WHOIS. Para que funcione corretamente, você precisará de uma chave de API válida.

Como Obter a Chave de API

  1. Acesse o site JSONWhois.
  2. Crie uma conta e faça o login.
  3. Vá até a seção API Keys.
  4. Copie sua chave de API.

Configuração no Código

  1. Abra o arquivo principal do projeto (index.php).
  2. Encontre a seguinte linha: 
    "Authorization" => "Token 2oroIPRSEKt0Ao1wGNenug" // Sua chave da API
  3. Substitua "2oroIPRSEKt0Ao1wGNenug" pela sua chave de API.

Como o Código Funciona

O código PHP realiza os seguintes passos:

  1. Recebimento do Domínio/IP

    • O usuário insere um domínio ou IP no formulário HTML.
    • O domínio/IP é validado para garantir que seja um endereço válido.

  2. Chamada à API JSONWhois

    • O código monta uma requisição HTTP para a API JSONWhois, utilizando a biblioteca Unirest.
    • A API retorna informações WHOIS detalhadas sobre o domínio ou IP fornecido.

  3. Processamento dos Dados

    • Se a resposta da API for bem-sucedida, os dados são organizados para exibição.
    • Em caso de erro, uma mensagem é exibida ao usuário.

  4. Exibição dos Resultados

    • As informações WHOIS são apresentadas ao usuário de forma estruturada, destacando detalhes como data de criação, expiração, servidores DNS, e mais.

Informações Retornadas

A API JSONWhois pode retornar diversas informações. Aqui estão os principais dados que este projeto exibe:

Informações Básicas

  • Domínio: O nome do domínio consultado.
  • Data de Criação: Quando o domínio foi registrado pela primeira vez.
  • Data de Expiração: Quando o registro do domínio expirará.
  • Última Atualização: A última vez que o domínio foi atualizado.
  • DNSSEC: Indica se o DNS do domínio possui extensões de segurança habilitadas.
  • Registrado: Um indicador booleano de registro do domínio.

Servidores DNS

  • Exibe a lista de servidores de nome (nameservers) associados ao domínio.

Execução do Projeto

  1. Suba o servidor local ou hospede o projeto em um servidor web.
  2. Acesse o projeto no navegador: 
    http://localhost:8000
  3. Digite um domínio ou IP no formulário e clique em Consultar WHOIS.
  4. Os resultados serão exibidos na tela em formato legível.

Se você tiver dúvidas ou encontrar problemas, por favor, abra uma issue no repositório do GitHub.