t e l i z e
_______________________
______ /_______
\ \ ___ // /
__ ____ __ / _____/ / ____
___/ ____/ _//____/ ______/_____ /__/ _//____
\__ ____ __/ __ __ ____ ____ __/ __///
/ _ |/ _ / / /_/ |/ _
\ ___/___ /____/_______/ ___/___ /
<0(--- __/ -h7- ______/ . __/ ---- ______/ --(0>
. /. .
. // /
______\ //______/
Y
Telize é uma API REST construída em Go que permite obter o endereço IP de um visitante e consultar informações de localização de qualquer endereço IP. Ele gera dados de geolocalização IP codificados em JSON e oferece suporte a JSON e JSONP.
As operações de geolocalização são realizadas usando o MaxMind DB Reader for Go, que armazena em cache o banco de dados na RAM. Portanto, o Telize tem uma sobrecarga mínima e deve ser extremamente rápido.
Telize requer as seguintes bibliotecas Go:
Telize requer os bancos de dados GeoLite2 gratuitos da MaxMind.
Telize irá procurar os bancos de dados GeoLite2 City
e GeoLite2 ASN
em /var/db/GeoIP
por padrão.
Construa e instale com a ferramenta go
, todas as dependências serão buscadas e compiladas automaticamente:
go build
go install telize
Por padrão, o Telize irá vincular no host local, porta 8080.
USAGE:
-host string
Set the server host (default "127.0.0.1")
-port string
Set the server port (default "8080")
-version
Display version
Telize vem com um arquivo de unidade systemd, consulte: systemd/telize.service
Copie o arquivo systemd/telize.service
em /etc/systemd/system
e o binário Telize em /usr/local/sbin
.
Para iniciar o daemon na inicialização, execute:
systemctl enable telize
Para documentação completa da API e exemplos de uso, verifique o site do projeto.
Telize oferece suporte a retornos de chamada JSONP.
Chamar o endpoint da API sem nenhum parâmetro retornará o endereço IP do visitante:
Anexar um endereço IP como parâmetro retornará informações de localização para o endereço fornecido:
Quando uma entrada incorreta do usuário é inserida, o servidor retorna um erro HTTP 400 (solicitação incorreta), juntamente com uma mensagem de erro codificada em JSON.
Telize lida com o cabeçalho HTTP 'X-Forwarded-For', se presente, e retorna dados para o primeiro endereço IP da lista.
Telize tem o CORS habilitado por padrão com a seguinte política:
Access-Control-Allow-Origin: *
Desde a versão 3.0.0, o Telize agora calcula dinamicamente as compensações de fuso horário (compensação de horário UTC) e adiciona dados à carga útil.
Telize é lançado sob a licença BSD de 2 cláusulas. Consulte o arquivo LICENSE
para obter detalhes.
Telize é desenvolvido por Frederic Cambus.
Página inicial do projeto: https://www.telize.com
Versão mais recente do tarball: https://www.statdns.com/telize/telize-3.1.1.tar.gz
GitHub: https://github.com/fcambus/telize