KALIDADE API • IP • GET • JSON

IP API

Consulte informações de localização e rede de um endereço IP através de uma requisição GET.

GET

https://api-kalidade.vercel.app/api/ip.js?ip=9.9.9.9

Sobre a API

O endpoint recebe um endereço IP através do parâmetro ip e retorna informações de localização, rede, ISP, ASN e outros dados em JSON.

Método

GET

Formato

JSON

Parâmetro

Como utilizar

Informe o endereço IP através do parâmetro ip.

Endpoint Copiar

https://api-kalidade.vercel.app/api/ip.js?ip=9.9.9.9

Exemplos de código

Exemplos prontos para integração.

JavaScript — Fetch Copiar

const ip = "9.9.9.9";

fetch(
    `https://api-kalidade.vercel.app/api/ip.js?ip=${encodeURIComponent(ip)}`
)
.then(response => {

    if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
    }

    return response.json();

})
.then(data => {

    console.log(data);

})
.catch(error => {

    console.error("Erro:", error);

});

JavaScript — Async/Await Copiar

async function consultarIP(ip) {

    const url =
        `https://api-kalidade.vercel.app/api/ip.js?ip=${encodeURIComponent(ip)}`;

    const response = await fetch(url);

    if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
    }

    const data = await response.json();

    console.log(data);

    return data;
}

consultarIP("9.9.9.9");

cURL Copiar

curl "https://api-kalidade.vercel.app/api/ip.js?ip=9.9.9.9"

Node.js Copiar

const ip = "9.9.9.9";

async function consultarIP() {

    const url =
        `https://api-kalidade.vercel.app/api/ip.js?ip=${ip}`;

    const response = await fetch(url);

    if (!response.ok) {
        throw new Error(`HTTP ${response.status}`);
    }

    const data = await response.json();

    console.log(data);
}

consultarIP();

Python Copiar

import requests

ip = "9.9.9.9"

url = "https://api-kalidade.vercel.app/api/ip.js"

response = requests.get(
    url,
    params={
        "ip": ip
    }
)

response.raise_for_status()

data = response.json()

print(data)

PHP Copiar

<?php

$ip = "9.9.9.9";

$url =
    "https://api-kalidade.vercel.app/api/ip.js?ip="
    . urlencode($ip);

$response = file_get_contents($url);

if ($response === false) {
    die("Erro ao consultar a API.");
}

echo $response;

CORS

Para aplicações web, a requisição pode ser feita diretamente pelo navegador caso o endpoint esteja configurado para aceitar CORS.

Fetch + CORS Copiar

const url =
    "https://api-kalidade.vercel.app/api/ip.js?ip=9.9.9.9";

fetch(url)
.then(response => response.json())
.then(data => {

    console.log(data);

})
.catch(error => {

    console.error("Erro:", error);

});

Parâmetros

Parâmetros disponíveis no endpoint.

Parâmetro	Obrigatório	Tipo	Exemplo	Descrição
ip	Sim	String	9.9.9.9	Endereço IP para consulta

Resposta JSON

Exemplo de resposta retornada pelo endpoint.

{
  "status": "success",
  "continent": "North America",
  "continentCode": "NA",
  "country": "United States",
  "countryCode": "US",
  "region": "CA",
  "regionName": "California",
  "city": "Berkeley",
  "district": "North Berkeley",
  "zip": "94709",
  "lat": 37.8806,
  "lon": -122.268,
  "timezone": "America/Los_Angeles",
  "offset": -25200,
  "currency": "USD",
  "isp": "Quad9",
  "org": "Quad9",
  "as": "AS19281 Quad9",
  "asname": "QUAD9-AS-1",
  "mobile": false,
  "proxy": false,
  "hosting": true,
  "query": "9.9.9.9"
}

Os campos retornados podem variar de acordo com o endereço IP consultado. A API atualmente retorna informações como localização, timezone, moeda, ISP, organização, ASN, proxy, hosting e o IP consultado.