Référence de l’API JSON
L’API publique ne nécessite pas de clé. Envoyez des requêtes HTTPS GET ; les réponses réussies sont en application/json. Les exemples illustrent le format, les valeurs peuvent varier.
Spécification OpenAPI (JSON)
GET /api/v1/me
Renvoie l’adresse IP et les informations réseau Edge disponibles pour la machine qui effectue la requête.
Paramètres: Aucun paramètre de requête.
Champs de réponse
ip- Adresse IP publique de l’appelant.
version- IPv4 ou IPv6.
location- Lieu approximatif ou null si indisponible.
network- Organisation réseau ou null.
asn- Numéro de système autonome ou null.
country- Code pays à deux lettres ou null.
latitude / longitude- Coordonnées approximatives ou null.
example- True uniquement pour l’exemple de prévisualisation locale.
Exemple de requête
curl https://myipgo.com/api/v1/me
Réponse illustrative
{
"ip": "203.0.113.42",
"version": "IPv4",
"location": "Amsterdam, Netherlands",
"network": "Example Network (AS64500)",
"asn": 64500,
"country": "NL",
"latitude": 52.37,
"longitude": 4.9,
"example": true
}
GET /api/v1/lookup
Renvoie la version IP validée et, si les données du fournisseur sont disponibles, le pays et l’ASN. Aucune ville n’est fournie.
Paramètres: Obligatoire : ip — adresse IPv4 ou IPv6.
Champs de réponse
ip- Adresse recherchée.
version- IPv4 ou IPv6.
source- Limited pour la validation seule ; IPinfo Lite si les données du fournisseur sont disponibles.
country- Pays, si disponible.
countryCode- Code pays à deux lettres, si disponible.
continent- Continent, si disponible.
continentCode- Code continent à deux lettres, si disponible.
network- Organisation réseau/ASN, si disponible.
asn- Identifiant de système autonome, si disponible.
as_domain- Domaine réseau associé, si disponible.
Exemple de requête
curl --get https://myipgo.com/api/v1/lookup --data-urlencode ip=1.1.1.1
Réponse illustrative
{
"ip": "1.1.1.1",
"version": "IPv4",
"source": "Limited"
}
Avec IPinfo Lite configuré, la réponse inclut aussi country, countryCode, continent, continentCode, network, asn et as_domain. L’absence de données du fournisseur ne signifie pas que l’adresse n’a aucun pays ou réseau.
GET /api/v1/dns
Interroge un enregistrement DNS et renvoie le code de réponse ainsi que jusqu’à 30 réponses.
Paramètres: Obligatoire : name (253 caractères maximum). Facultatif : type — A, AAAA, CNAME, MX, NS, TXT, SOA ou PTR ; valeur par défaut : A.
Champs de réponse
query- Nom envoyé au résolveur DNS.
type- Type d’enregistrement demandé.
status- Code DNS ; 0 signifie NOERROR et 3 NXDOMAIN. Un code DNS négatif peut tout de même être accompagné de HTTP 200.
records- Réponses DNS ; vide en l’absence de réponse.
records[].type- Type d’enregistrement.
records[].value- Données de l’enregistrement sous forme de texte.
records[].ttl- Durée de vie en secondes.
Exemple de requête
curl --get https://myipgo.com/api/v1/dns --data-urlencode name=example.com --data-urlencode type=A
Réponse illustrative
{
"query": "example.com",
"type": "A",
"status": 0,
"records": [
{ "type": "A", "value": "192.0.2.1", "ttl": 300 }
]
}
La réponse utilise une adresse réservée à la documentation. Une requête valide sans enregistrement renvoie HTTP 200, un tableau records vide et le statut du résolveur.
GET /api/v1/reverse
Construit le nom de résolution inverse d’une adresse IPv4 ou IPv6 et interroge ses enregistrements PTR.
Paramètres: Obligatoire : ip — adresse IPv4 ou IPv6.
Champs de réponse
query- Nom in-addr.arpa (IPv4) ou ip6.arpa (IPv6) généré.
type- PTR.
status- Code DNS ; 0 signifie NOERROR et 3 NXDOMAIN.
records- Jusqu’à 30 réponses PTR avec type, value et ttl.
Exemple de requête
curl --get https://myipgo.com/api/v1/reverse --data-urlencode ip=1.1.1.1
Réponse illustrative
{
"query": "1.1.1.1.in-addr.arpa",
"type": "PTR",
"status": 0,
"records": [
{ "type": "PTR", "value": "one.one.one.one", "ttl": 300 }
]
}
Les réponses et TTL varient selon les données DNS. query contient le nom inverse généré, pas l’adresse IP d’origine.
IP en ligne de commande
Affiche uniquement l’adresse de la machine qui effectue la requête. L’adresse principale renvoie du texte brut aux clients de terminal courants ; les navigateurs affichent toujours le site. Utilisez /ip pour un point d’accès texte explicite.
curl -fsS https://myipgo.com
curl -fsS https://myipgo.com/ip
curl -fsS https://myipgo.com/json
curl -fsS https://myipgo.com/asn
curl -fsS https://myipgo.com/country
curl -fsS https://myipgo.com/city
npx myipgo
Erreurs HTTP
Les erreurs sont des objets JSON avec une chaîne error. Une réponse DNS négative est différente : HTTP 200 avec un statut DNS non nul.
400Entrée invalideAdresse IP, requête DNS ou CIDR/préfixe IPv4 invalide.
403Origin refuséeL’Origin MCP ne correspond pas à l’hôte de la requête.
404Point d’accès inconnuAucun point d’accès /api/v1 correspondant.
405Méthode non autoriséeL’API JSON exige GET ; MCP exige POST.
503Service amont indisponibleRésolveur ou fournisseur IP indisponible ; réessayez plus tard.
{ "error": "Invalid IP address" }
Aucun quota numérique n’est publié. Utilisez un rythme raisonnable et évitez les interrogations répétées trop fréquentes.
MCP via Streamable HTTP
Connectez un client MCP à https://myipgo.com/mcp via Streamable HTTP. Aucune clé API n’est requise. Le point d’accès est sans état ; un SDK MCP récent gère l’initialisation et le format des messages.
Outils disponibles
my_ip- Aucun argument. Renvoie l’IP du serveur appelant et les informations Edge approximatives disponibles.
lookup_ip- ip (string, obligatoire). Renvoie pays/réseau/domaine si disponibles ; aucune ville.
dns_lookup- name (string, obligatoire) ; type (A, AAAA, CNAME, MX, NS, TXT ou SOA ; facultatif, A par défaut).
reverse_dns- ip (string, obligatoire). Recherche les enregistrements PTR IPv4 ou IPv6.
subnet_calculator- cidr (string, obligatoire). Calcule un sous-réseau IPv4 ; préfixes de 0 à 32. Renvoie réseau, diffusion (null pour /31 et /32), plage d’hôtes, masques et nombres d’adresses.
Exemple de client Node.js
npm install @modelcontextprotocol/sdk
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const client = new Client({ name: 'myipgo-client', version: '1.0.0' });
await client.connect(new StreamableHTTPClientTransport(
new URL('https://myipgo.com/mcp')
));
const result = await client.callTool({
name: 'subnet_calculator',
arguments: { cidr: '192.168.1.0/24' }
});
if (result.isError) throw new Error(result.content[0]?.text);
console.log(result.structuredContent ?? result.content);
await client.close();
Les outils réussis renvoient un bloc de texte JSON et structuredContent. Les erreurs d’outil renvoient isError: true et un message texte ; les erreurs de protocole ou de transport sont distinctes.