O que lançamos este mês: geocodificação, IP, fuso horário e mais
Um resumo do trabalho recente em toda a API: novos hosts de compatibilidade, consultas de fuso horário e altitude mais rápidas, recursos no painel e mais visibilidade sobre a cota.
Detalhes de ameaças e de rede do IP disponíveis sob demanda
A localização muitas vezes é só uma parte do que importa em um endereço IP. Saber se esse endereço está associado a atividades de ameaça conhecidas, e a que tipo de rede ele realmente pertence, pode importar tanto quanto para prevenção de fraudes, controle de acesso ou avaliação de risco em geral. /v1/ip agora retorna exatamente essas informações como um extra opcional, disponível sempre que você pedir.
Adicionar mg_extras=1 a uma requisição, ou enviar um cabeçalho X-MG-Extras, acrescenta detalhes de ameaças e de rede de IP à resposta de localização padrão, sem alterar nada nos campos básicos já retornados. Deixe essa opção desligada e a resposta será exatamente a de sempre. Adicione-a e a mesma chamada retorna detalhes adicionais junto com os campos de localização que você já recebe.
Esse mesmo mecanismo também se aplica à altitude do terreno, então mg_extras=1 é uma forma única e consistente de pedir mais profundidade em diferentes endpoints, em vez de uma opção separada para cada recurso. Ele também funciona em nossos hosts de compatibilidade, de modo que uma requisição no formato de ip-api.com, ipinfo.io ou ipstack pode adicionar a mesma opção ou cabeçalho ao seu formato de requisição e resposta, que de resto é idêntico, e obter detalhes de ameaças e de rede sem quebrar a compatibilidade com o formato original.
O preço não muda conforme os extras sejam pedidos ou não. Uma consulta com mg_extras=1 conta como a mesma requisição única na sua cota gratuita, no crédito pré-pago ou no pacote Unlimited que uma consulta sem ele. Não existe um nível separado e mais caro para os detalhes adicionais, nem uma cota separada a acompanhar especificamente para os extras.
Isso é voltado diretamente para casos de uso em que só a localização não basta. Uma aplicação que analisa cadastros em busca de atividade suspeita, um serviço que decide se aplica verificação extra a uma determinada conexão ou uma ferramenta de segurança que monta um panorama mais amplo da reputação de redes podem obter esse contexto diretamente da mesma chamada a /v1/ip que já fazem, em vez de manter uma segunda integração com um provedor separado de inteligência de ameaças só para essa informação.
A documentação completa dos endpoints de IP, incluindo como adicionar extras, está disponível em /docs/ipv4-lookup/ e /docs/ipv6-lookup/. Como é totalmente opcional, testar isso em uma integração existente é tão simples quanto adicionar uma opção a uma chamada que você já faz.