API
Los mismos datos que el sitio, en JSON o texto plano. Sin clave ni cuenta; se aplican límites de uso razonables.
curl https://ipaddress.pt/api/v1/my-ip?format=textEndpoints
| Ruta | Descripción | Datos | Límites de uso |
|---|---|---|---|
| GET/api/v1/my-ipProbar: /api/v1/my-ip | Tu dirección IP (también en texto plano con ?format=text). | Datos propios | 120 · 240/min |
| GET/api/v1/ip/{address}Probar: /api/v1/ip/1.1.1.1 | Datos de red, enrutamiento, registro y ubicación de una dirección. | Datos propios | 30 · 30/min |
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.pt/api/v1/bulk | Hasta 100 direcciones a la vez (JSON {"addresses": […]} o una por línea), respondidas solo desde nuestros propios datos. No se guarda nada. | Datos propios | 6 · 3/min |
| GET/api/v1/asn/{asn}Probar: /api/v1/asn/AS3243 | Titular, registro y prefijos anunciados de un sistema autónomo. | Datos propios | 30 · 30/min |
| GET/api/v1/network/{cidr}Probar: /api/v1/network/193.136.0.0/15 | Una red en notación CIDR: tamaño, rango, uso especial, quién la anuncia (con RPKI), la delegación en el registro y una estimación de ubicación. | Datos propios | 30 · 30/min |
| GET/api/v1/country/{cc}Probar: /api/v1/country/PT | El espacio de direcciones y los números de AS registrados en un país, lo que anuncian sus redes, la cobertura RPKI y las redes principales (para PT, también la estimación por distrito). | Datos propios | 30 · 30/min |
| GET/api/v1/dns/{domain}?type=A,MXProbar: /api/v1/dns/dns.pt?type=A,MX | Registros DNS actuales de un dominio. | Consulta en directo | 40 · 60/min |
| GET/api/v1/rdap/{query}Probar: /api/v1/rdap/AS3243 | Datos de registro del servidor RDAP responsable. | Consulta en directo | 10 · 6/min |
| GET/api/v1/healthProbar: /api/v1/health | Disponibilidad del servicio. | Datos propios | 120 · 240/min |
| GET/api/v1/data-statusProbar: /api/v1/data-status | Antigüedad y tamaño de cada conjunto de datos. | Datos propios | 120 · 240/min |
Atajos en texto plano fuera de /api/v1: /raw devuelve su dirección, /json el mismo objeto que /my-ip y /country el código de país estimado.
curl ipaddress.pt/rawcurl ipaddress.pt/jsoncurl ipaddress.pt/countryLímites de uso
Las solicitudes se limitan por dirección de cliente con un cubo de fichas. Al alcanzar el límite, la API responde 429 con una cabecera Retry-After. El recuento se hace en memoria con una clave cifrada que cambia a diario; no se guardan direcciones.
Errores
Los errores usan códigos de estado HTTP y un cuerpo JSON de la forma {"error": {"code": "…", "message": "…"}}.
Versiones
Las rutas bajo /api/v1/ mantienen su estructura de respuesta. Pueden añadirse campos nuevos; los existentes no se eliminan ni se renombran dentro de v1.
Atribución
Los datos de ubicación proceden de DB-IP (CC BY 4.0). Si los muestras, cita a DB-IP como exige la licencia.