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.
/api/ip procesa una IP pública por solicitud. No hay endpoint masivo, ni autenticación, ni garantía de disponibilidad.
Ú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.
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": "[email protected]",
"email_tech": null
}
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.
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.
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.