Guide de l'API de recherche IP pour /api/ip
Utilisez ce guide pour envoyer une demande de recherche d'adresse IP unique à /api/ip, comprendre les champs JSON qui reviennent, puis basculer vers le flux de travail du navigateur en direct lorsque vous avez besoin de plus de contexte.
/api/ip gère une adresse IP publique par requête. Il n'y a pas de point de terminaison en masse, pas d'authentification et aucune garantie de disponibilité.
Utilisez-le lorsque
Vous souhaitez une sortie JSON pour une seule recherche d'adresse IP publique et vous avez besoin du modèle de requête exact avant d'automatiser une récupération ou un appel CLI.
Contrat en cours
/api/ip nécessite un paramètre de requête ip et renvoie le contexte de propriété JSON pour une adresse IP publique à la fois.
Garde-corps
Les entrées non valides, privées ou réservées renvoient une erreur JSON. Cette surface ne promet pas de recherche groupée, d'authentification ou d'engagement de disponibilité.
Exemple de récupération du navigateur
Utilisez une simple requête GET lorsqu'un script frontal ou de débogage nécessite le même ASN et le même contexte réseau que ceux affichés dans la recherche du navigateur.
fetch("/api/ip?ip=8.8.8.8")
.then((response) => response.json())
.then((data) => console.log(data));
Exemple de boucle CLI
Envoyez explicitement le paramètre de requête ip lorsque vous souhaitez JSON au lieu du raccourci du terminal en texte brut /ip.
curl https://comutil.com/api/ip?ip=8.8.8.8
Exemples de champs de réponse
Le point de terminaison en direct renvoie des métadonnées ASN de niveau supérieur ainsi qu'un objet réseau imbriqué provenant du flux de recherche RDAP et WHOIS actuel.
{
"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
}
Commencez par les champs qui expliquent la propriété et la plage avant d’interpréter l’adresse ou les coordonnées.
- asn_registry, asn et asn_description vous indiquent le registre et l'opérateur que vous consultez.
- network.start_address, network.end_address et network.status affichent la plage visible et le contexte du cycle de vie de l'allocation.
- address, email_admin et email_tech peuvent aider avec les notes d'escalade, mais ils fournissent des détails plutôt que le premier signal de triage.
Ce sont les contraintes actuelles du point de terminaison en direct, alors gardez votre automatisation alignée sur celles-ci.
- L'adresse IP manquante renvoie {"error": "IP address is required."}.
- Les adresses privées ou réservées renvoient l'erreur JSON au lieu des données de propriété publique.
- Une entrée mal formée renvoie une erreur JSON qui explique le format IP non valide.
Utilisez la route des documents pour comprendre le contrat, puis passez au flux de travail du navigateur en direct lorsque vous avez besoin d'un contexte d'enquête plus riche ou d'une page de recherche partageable.
- Ouvrez /ip lorsque vous souhaitez accéder à l'interface utilisateur du navigateur, partager l'URL, la carte et le résumé de l'enquête autour de la même recherche.
- Lisez le guide IP et ASN lorsque vous avez besoin du cadrage du workflow, pas seulement des champs JSON.
- Revenez au hub Réseau/Sécurité lorsque la question s'étend à la propriété du domaine ou à la portée CIDR.