IPCOUNTRY - Ferramenta de pesquisa de alocação de endereços IPv4/IPv6 por País

DESCRIÇÃO:
	Esta ferramenta baixa os arquivos de delegação de zona de todos os RIR's e compila as mesmas num banco de dados para posterior consulta através da ferramenta. As informações são atualizadas a cada 4 horas.
	

FORMATOS DE RETORNO:
- TXT: Retorna um arquivo delimitado por padrão pelo caractere Barra Vertical (ASCII 124) "|" ou por delimitador especificado pelo usuário através de parâmetro específico, explicado na seção PARÂMETROS;
- XML: Retorna os valores em formato XML sem DTD
- JSON: Retorna os valores no formato JSON;
- CIDR: Retorna os valores da consulta utilizando NOTAÇÃO CIDR. Note que, nesta consulta, APENAS OS ENDERECOS IP E SUAS MÁSCARAS SERÃO RETORNADOS.

CAMPOS (VALORES) PADRÃO RETORNADOS:
1 - Endereço IP;
2 - Máscara;
3 - Tipo (IPv4 ou IPv6);
4 - Código ISO 3166-1 alfa-2  (duas letras) de idenficação do país (BR, EU, US, etc);
5 - Número do AS ao qual o Endereço IP Pertence;
6 - Código Relativo (fornecido nos arquivos do ARIN);
Os campos retornados sempre estarão descritos ou no cabeçalho do arquivo (no caso dos retorno no formato TXT), como TAG (no caso do retorno em formato XML) ou como chave (no caso de retorno em formato JSON). 
Os campos sempre terão algum valor, ou zero no caso do mesmo não existir, ou com uma informação inválida apenas para constar o retorno do mesmo.
São retornadas também algumas informações adicionais em locais específicos, dependendo do formato de retorno. São elas:
- UPDATES: Número de atualizações feitas no banco de dados
- LATESTUPDATE: Data/Hora da última atualização efetuada no banco de dados
- UNIXTIME: Data/Hora no formato UNIX da última atualização efetuada no banco de dados
Nos arquivos TXT, essa informação é retornada no cabeçalho como item informacional. No XML e no JSON são retornados como campos específicos.
Se o parâmetro CIDR for utilizado, só retornará o endereçamento IP e as respectivas máscaras na consulta. Útil para retornar os endereços IP's alocados para um determinado país / ASN.


PARÂMETROS ACEITOS (ATRAVÉS DOS MÉTODOS GET OU POST, TODOS EM MINÚSCULO):
Observações gerais:
	- Os parâmetros "asn" e "country" são mutualmente excludentes. Se você utilizar um, não pode utilizar o outro. Caso sejam utilizados ambos na consulta, será considerado apenas o parâmetro "asn" para consulta;
	
Parâmetro: asn
Tipo: inteiro
Descrição: Faz um filtro dos endereços IP alocados para este ASN
Valores aceitos: qualquer número inteiro de um ASN. Se o valor for igual a 0 (ZERO) retornará a tabela de consulta de todos os ips cadastrados (poderá demorar).

Parâmetro: country
Tipo: caractere (duas posições)
Descrição: quando fornecido o código ISO 3166-1 alfa-2 o sistema fará a busca de todos os ASN's e endereços IP associados a este país. Se o valor for igual a 'XX' retorna a tabela de consulta de todos os países cadastrados (pode demorar).
Valores aceitos: BR, EU, US, UK, PL, etc

Parâmetro: v
Tipo: inteiro
Descrição: Retorna apenas os endereços IP baseados na sua versão (IPv4 ou IPv6)
Valores aceitos: 4 para IPv4 ou 6 para IPv6

Parâmetro: ip
Tipo: caractere
Descrição: Retorna as informações de ASN e país de um determinado endereço ip. Se o valor for igual a 'myip', ele retornará as informações do endereço ip que fez a consulta ao servidor.
Valores aceitos: myip ou um endereço IPv4/IPv6 válido

Parâmetro: ordby
Tipo: inteiro
Descrição: Número do campo para ordenação dos valores retornados. Pode ser utilizado quaisquer um dos campos padrão.
Valores aceitos: Qualquer número de 1 a 6

Parâmetro: separator
Tipo: caractere (uma posição)
Descrição: Define um separador no caso de arquivos tipo TEXTO. Sem uso para os outros formatos
Valores aceitos: qualquer letra. Logicamente se você utilizar QUALQUER letra poderá ter problemas no trato do retorno da informação

Parâmetro: type
Tipo: caractere
Descrição: Define o formato de retorno (TXT,XML ou JSON). O retorno CIDR é um tipo especial que retorna o IP e a Máscara dos blocos IPv4 e IPv6.
Valores aceitos: txt,xml,json,cidr

URL DA CONSULTA: http://vps3.lucas.inf.br/ipcountry/iplist.php

EXEMPLOS DE CONSULTA:
- http://vps3.lucas.inf.br/ipcountry/iplist.php?asn=0: Irá retornar TODO o banco de dados de ASN em formato JSON (pode demorar um pouco)
- http://vps3.lucas.inf.br/ipcountry/iplist.php?country=XX: Irá retornar TODO o banco de dados dos países em formato JSON (pode demorar um pouco)
- http://vps3.lucas.inf.br/ipcountry/iplist.php?asn=10954: Irá retornar as informações do ASN 10954
- http://vps3.lucas.inf.br/ipcountry/iplist.php?asn=10954&type=cidr: Irá retornar todos os blocos alocados para o ASN 10954
- http://vps3.lucas.inf.br/ipcountry/iplist.php?country=BR&type=cidr: Irá retornar todos os blocos alocados para o país BR