Guía de la API de búsqueda de IP para /api/ip

Use esta guía para enviar una solicitud de consulta de una sola IP a /api/ip, entender los campos JSON que regresan y luego pasar al flujo en vivo del navegador cuando necesite más contexto.

Mantenga el alcance en los hechos: /api/ip es una ayuda de consulta para una IP pública a la vez. No es un producto de API masiva, autenticada ni respaldada por SLA.

Open IP lookup Volver al centro de Red/Seguridad
Úsalo cuando
Quiere salida JSON para una consulta de una sola IP pública y necesita el patrón exacto de la solicitud antes de automatizar un fetch o una llamada por CLI.
Contrato actual
/api/ip requiere un parámetro de consulta ip y devuelve contexto de propiedad en JSON para una IP pública a la vez.
Barandilla
Las entradas no válidas, privadas o reservadas devuelven JSON de error. Esta superficie no promete consultas masivas, autenticación ni compromisos de disponibilidad.
Ejemplos de solicitudes y respuesta
Ejemplo de fetch en el navegador
Use una solicitud GET simple cuando un frontend o script de depuración necesite el mismo ASN y contexto de red que muestra la consulta del navegador. 
fetch("/api/ip?ip=8.8.8.8")
  .then((response) => response.json())
  .then((data) => console.log(data));
Ejemplo de curl en CLI
Envíe explícitamente el parámetro de consulta ip cuando quiera JSON en lugar del atajo de terminal /ip en texto plano. 
curl https://comutil.com/api/ip?ip=8.8.8.8
Campos de respuesta de ejemplo
El endpoint en vivo devuelve metadatos de ASN de nivel superior junto con un objeto network anidado obtenido del flujo actual de consulta de RDAP y WHOIS. 
{
  "asn_registry": "arin",
  "asn": "15169",
  "asn_cidr": "8.8.8.0/24",
  "asn_country_code": "US",
  "asn_date": "1992-12-01",
  "asn_description": "GOOGLE, US",
  "network": {
    "name": "GOGL",
    "country": "US",
    "start_address": "8.8.8.0",
    "end_address": "8.8.8.255",
    "type": "DIRECT ALLOCATION",
    "status": "active",
    "links": []
  },
  "nir_postal_code": null,
  "nir_range": null,
  "address": "1600 Amphitheatre Parkway",
  "email_admin": "arin-contact@google.com",
  "email_tech": null
}
Lea primero estos campos de respuesta

Empiece por los campos que explican la propiedad y el rango antes de interpretar la dirección o los datos de contacto.

  • asn_registry, asn y asn_description le indican qué registro y operador está viendo.
  • network.start_address, network.end_address y network.status muestran el rango visible y el contexto del ciclo de vida de la asignación.
  • address, email_admin y email_tech pueden ayudar con notas de escalamiento, pero son detalles de apoyo y no la primera señal de triaje.
Límites de error

Estas son las restricciones actuales del endpoint en vivo, así que mantenga su automatización alineada con ellas.

  • Si falta ip, devuelve {"error": "IP address is required."}.
  • Las direcciones privadas o reservadas devuelven JSON de error en lugar de datos públicos de propiedad.
  • Una entrada mal formada devuelve JSON de error que explica el formato de IP no válido.
Cuándo salir de la documentación de la API

Use la ruta de documentación para entender el contrato y luego pase al flujo en vivo del navegador cuando necesite más contexto de investigación o una página de consulta que pueda compartir.

  • Abra /ip cuando quiera la interfaz web, la URL para compartir, el mapa y el resumen de investigación de la misma consulta.
  • Lea la guía de IP y ASN cuando necesite el marco del flujo de trabajo y no solo los campos JSON.
  • Vuelva al centro de Red/Seguridad cuando la pregunta se amplíe a la propiedad del dominio o al alcance CIDR.
Continuar con el flujo de investigación en vivo
Guía de IP y ASN
Lea la guía enfocada en la investigación cuando necesite la interpretación del flujo de trabajo sobre los mismos datos de propiedad.
Flujo de trabajo de investigación
Siga la secuencia más amplia dominio -> IP -> CIDR cuando la consulta se convierta en un flujo real de triaje.
Centro de Red/Seguridad
Vuelva al centro para ver las tarjetas de inicio rápido y la franja más amplia de decisiones de investigación.Regrese al centro para las tarjetas de inicio rápido y la barra de decisión entre herramientas.
WHOIS vs RDAP guide
Use la comparación de protocolos cuando necesite explicar por qué el flujo de IP en vivo muestra datos estructurados de propiedad del registro.