Inicio

Última Actualización: 01 Mayo del 2022

Introducción

Con esta API se pueden obtener algunos datos de una IP dada. Entra las cuales destacan las siguientes:

-Obtención del continente de la IP
-Obtención del código de continente de la IP
-Obtención del país de la IP
-Obtención del código de país de la IP
-Obtención de latitud de la IP (ISP)
-Obtención de longitud de la IP (ISP)
-Obtención de url de google maps de las coordenadas de la IP (ISP)
-Obtención de url insertable de google maps de las coordenadas de la IP (ISP)


Todos los métodos disponibles de la API reciben la petición por GET, por lo que podrás probar directo en tu navegador.

Registro

Por ahora no se debe registrar. Posteriormente se deberá crear una cuenta para ocupar la API. Estar al pendiente para su registro en un futuro.

Endpoint

Para acceder a la API, se deberá ingresar al siguiente ENDPOINT:

https://api-ip.info/api/InfoIP/{type}/{ip}?lang={lang}

  • En donde {type} será un parámetro obligatorio. Podrá ser xml o json.
  • En donde {ip} será un parámetro opcional.
  • En donde {lang} será una variable tipo GET opcional.

Respuesta del servidor

Una vez que se haya hecho el request, el servidor regresará un código 200 http si todo salió de forma correcta, o devolverá un código 400 http si hubo un error en el envío de los parámetros al endpoint. En cualquier caso devolverá un json o xml, según sea el caso.



Ejemplo de una respuesta en JSON: 


{
    "multiserviciosweb": {
        "error": false,
        "message": "",
        "response": {
        }
    }
}

  • En donde {error} será una variable tipo bool. Indicará si hubo un error
  • En donde {message} será una variable tipo string. Indicará el mensaje de error o éxito, según sea el caso.
  • En donde {response} será una variable tipo array. Devolverá la información de la validación.

Ejemplo de una respuesta en XML: 

<?xml version="1.0"?>
<InfoIP>
  <multiserviciosweb>
    <error/>
    <message/>
    <response/>
  </multiserviciosweb>
</InfoIP>

  • En donde el nodo <error/> será una variable tipo int. 1 Indicará si hubo un error. Se colapsa en caso de que no haya error
  • En donde el nodo <message/> será una variable tipo string. Indicará el mensaje de error o éxito, según sea el caso. Se colapsa en caso de que no haya mensaje
  • En donde el nodo <response/> será un nodo padre con nodos hijo. Devolverá la información de la validación. Se colapsa en caso de que haya error


Referencia de response:
continentName Nombre del continente. (Si se especifica el lenguaje por medio de la variable lang. Lo devolverá en el lenguaje especificado)
continentCode Código de continente.
countryName Nombre de país. (Si se especifica el lenguaje por medio de la variable lang. Lo devolverá en el lenguaje especificado)
countryCode Código de país.
cityName Nombre de la ciudad.
postalCode Código postal.
latitude Latitud decimal.
longitude Longitud decimal.
timeZone Zona horaria.
urlGoogleMaps URL para ver ubicación en google de las coordenadas de latitud y longitud.
mapGoogleMaps URL para insertar mapa de google en un iframe, de las coordenadas de latitud y longitud.

Info IP

Obtener Información y ubicación a de una IP

Primeramente se deberá definir el tipo de respuesta se deberá ingresar el parámetro {type} en el tercer segmento de la url. Este parámetro es obligatorio. En caso de no enviarse responderá con un error en texto plano
Ejemplo:

https://api-ip.info/api/InfoIP/{type}/


el valor de type podrá ser:
json Se deberá ingresar "json" en minúsculas. Devolverá el resultado en formato JSON
xml Se deberá ingresar "xml" en minúsculas. Devolverá el resultado en formato XML


Una vez definido el tipo de respuesta, se podrá enviar una IP en el cuarto segmento de la URL de forma opcional. En caso de que no se envíe se obtendrá la ubicación de la IP del cliente de la solicitud.

https://api-ip.info/api/InfoIP/{json|xml}/
Devolverá la información de la ip del cliente que hace la petición.

https://api-ip.info/api/InfoIP/{json|xml}/{ipv4|ipv6}
Devolverá la información de la ip del cuarto segmento de la URL. Puede ser formato IPV4 o IPV6


Ejemplo para obtener la información de la IP del cliente en formato json y nos devolverá lo siguiente:

https://api-ip.info/api/InfoIP/json/ 


{
    "multiserviciosweb": {
        "error": false,
        "message": "",
        "response": {
            "continentName": "South America",
            "continentCode": "SA",
            "countryName": "Argentina",
            "countryCode": "AR",
            "cityName": "Buenos Aires",
            "postalCode": "1425",
            "latitude": -36,
            "longitude": -59.9964,
            "timeZone": "America\/Argentina\/Buenos_Aires",
            "urlGoogleMaps": "https:\/\/maps.google.com\/maps?hl=es&q=-36,-59.9964+(AR)&t=&z=14&ie=UTF8&iwloc=B",
            "mapGoogleMaps": "http:\/\/api-ip.info\/api\/map\/-36\/-59.9964\/AR"
        }
    }
}


Ejemplo para obtener la información de la IP dada:

https://api-ip.info/api/InfoIP/xml/1.178.63.255 

<?xml version="1.0"?>
<InfoIP>
  <multiserviciosweb>
    <error/>
    <message/>
    <response>
      <continentName>South America</continentName>
      <continentCode>SA</continentCode>
      <countryName>Argentina</countryName>
      <countryCode>AR</countryCode>
      <cityName>Buenos Aires</cityName>
      <postalCode>1425</postalCode>
      <latitude>-36</latitude>
      <longitude>-59.9964</longitude>
      <timeZone>America/Argentina/Buenos_Aires</timeZone>
      <urlGoogleMaps>https://maps.google.com/maps?hl=es&amp;q=-36,-59.9964+(AR)&amp;t=&amp;z=14&amp;ie=UTF8&amp;iwloc=B</urlGoogleMaps>
      <mapGoogleMaps>http://api-ip.info/api/map/-36/-59.9964/AR</mapGoogleMaps>
    </response>
  </multiserviciosweb>
</InfoIP>


Se puede definir el idioma de respuesta para continente y país mediante una variable tipo GET llamada {lang}". En caso de que el idioma no se encuentra disponible, de forma automática se cambiará a ingles. Los idiomas disponibles son los siguientes:

de Alemán
en Inglés
es Español
fr Frances
ja Japones
pt-BR Portugués (Brasil)
ru Ruso
zh-CN Chino


Ejemplo

https://api-ip.info/api/InfoIP/json/8.8.8.8?lang=fr 

{
    "multiserviciosweb": {
        "error": false,
        "message": "",
        "response": {
            "continentName": "Amérique du Sud",
            "continentCode": "SA",
            "countryName": "Argentine",
            "countryCode": "AR",
            "cityName": "Buenos Aires",
            "postalCode": "1425",
            "latitude": -36,
            "longitude": -59.9964,
            "timeZone": "America\/Argentina\/Buenos_Aires",
            "urlGoogleMaps": "https:\/\/maps.google.com\/maps?hl=es&q=-36,-59.9964+(AR)&t=&z=14&ie=UTF8&iwloc=B",
            "mapGoogleMaps": "http:\/\/api-ip.info\/api\/map\/-36\/-59.9964\/AR"
        }
    }
}

Changelog

En esta sección aparecerán los cambios hechos en la API, desde el día de su publicación

  • 01/05/2022 - Creación y publicación de la API