Documentação — IPRapid

API

API HTTP e JSON

Sem autenticação

Os endpoints principais não exigem conta nem cookie. As respostas dinâmicas usam Cache-Control: no-store e cabeçalhos de limite de pedidos.

API v1

JSON estável

JSON snake_case versionado para consultas próprias e de destino com contrato estável.

GET/api/v1/self

Resultado estruturado do IP atual com campos de rede, localização e ASN.

curl --fail --silent --show-error https://iprapid.com/api/v1/self

GET/api/v1/lookup/{ip}

Consulta estruturada de um endereço IPv4 ou IPv6 validado.

curl --fail --silent --show-error https://iprapid.com/api/v1/lookup/8.8.8.8

GET/api/v1/meta

schema_version · capabilities · fields

curl --fail --silent --show-error https://iprapid.com/api/v1/meta

JSON

Compatibilidade

Caminho	Resposta
`GET /`	Raiz com negociação de conteúdo: JSON para CLI e /, um IP para text/plain e HTML SSR quando text/html é pedido explicitamente.
`GET /json`	Resultado estruturado do IP atual com campos de rede, localização e ASN.
`GET /json/{ip}`	Consulta estruturada de um endereço IPv4 ou IPv6 validado.
`GET /ip/{ip}`	IP de destino normalizado para clientes automáticos; página noindex apenas num pedido HTML explícito.

curl -sS https://iprapid.com/json
curl -sS https://iprapid.com/json/8.8.8.8

Terminal

TEXT / ANSI

Caminho	Resposta
`GET /ip`	IP atual normalizado seguido de uma mudança de linha.
`GET /info[/{ip}]`	Texto UTF-8 detalhado, com etiquetas e ordem estáveis e sem controlos ANSI.
`GET /ansi[/{ip}]`	Vista /info com cores SGR permitidas e ativadas explicitamente.
`GET /field/{field}[/{ip}]`	Um valor permitido seguido de mudança de linha; 204 quando indisponível.

curl iprapid.com
curl -4 iprapid.com
curl -6 iprapid.com

curl.exe iprapid.com
curl.exe -4 iprapid.com
curl.exe -6 iprapid.com

API v1 · JSON

APPLICATION/JSON

{
  "schema_version": "1",
  "query": {
    "type": "lookup",
    "ip": "8.8.8.8",
    "ip_version": 4
  },
  "network": {
    "asn": 15169,
    "as_organization": "Google LLC"
  },
  "location": {
    "continent_code": "NA",
    "country_code": "US",
    "country": "United States",
    "region_code": null,
    "region": null,
    "city": null,
    "postal_code": null,
    "timezone": "America/Chicago",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822,
      "accuracy_radius_km": 1000
    }
  },
  "data": {
    "status": "available",
    "built_at": "2026-03-03T08:15:43Z"
  },
  "observed_at": "2026-07-25T12:23:07Z"
}

Metodologia e limites dos sinais

O serviço separa os dados de rede observados pelo servidor, os conjuntos geográficos locais e os indícios do navegador, sem confundir sinais diferentes.

O IP público apresentado é o endereço observado pelo serviço nesta ligação HTTP.
País, região, cidade, fuso horário, coordenadas, ASN e organização provêm de um conjunto de dados local.
Os testes de WebRTC, DNS, idioma, fuso horário e IPv6 são observações independentes feitas no navegador.
Indisponível, desconhecido, sem observação e divergência são estados diferentes.

Precisão e atualização

A geolocalização IP descreve uma atribuição de rede, não um dispositivo ou residência. A cidade e as coordenadas podem estar distantes; o raio de precisão é uma estimativa, não uma garantia.

Privacidade e retenção

A consulta não grava IPs em bruto, URIs, cabeçalhos ou impressões nos agregados PostgreSQL. As ligações assinadas contêm apenas estados reduzidos, expiram em 24 horas e não são guardadas como registos.

Perguntas frequentes

A cidade apresentada é a minha localização exata?

Não. A geolocalização IP é uma estimativa aproximada ao nível da rede. Consulte o raio de precisão e não a trate como uma morada exata.

O serviço guarda a minha consulta de IP na base de dados?

A aplicação não guarda endereços IP em bruto nos agregados de utilização. Os registos web restritos são geridos separadamente.

Porque pode o IPv6 aparecer como desconhecido em vez de indisponível?

Um teste não configurado, bloqueado ou inconclusivo não prova a ausência de IPv6; o estado permanece desconhecido até existir um resultado claro.

O que contém uma ligação de diagnóstico partilhada?

Apenas estados reduzidos, horas de emissão e expiração e uma assinatura; sem IP, coordenadas ou endereços de resolvedores DNS.