La API Info IP es un conjunto de números que identifica, de manera lógica y jerárquica, a una interfaz en la red de un dispositivo que utilice el protocolo o, que corresponde al nivel de red del modelo TCP/IP, por lo que le devolverá en detalle dicha información.
Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:
- Endpoint:
https://cont.certisend.com/web/container/api/v1/database/ip/infoip
Parámetros:
- token-susc: Token obtenido al momento de la suscripción a nivel empresa.
- token-api: Token obtenido al momento de la suscripción a nivel API.
- ip: Número de IP a chequear.
- internalid: Parámetro opcional en donde se puede enviar un id interno para su identificación por parte del cliente.
La llamada quedaría de la siguiente manera:
https://cont.certisend.com/web/container/api/v1/database/ip/infoip?token-susc=TOKENSUSC&token-api=TOKENAPI&ip=2003&internalid=13
Una vez realizada la llamada van a recibir los siguientes parámetros:
- state: Tendrá el valor 0 para un parámetro faltante y un 1 en el caso de que se encuentre información.
- ip: IP solicitada.
- type: Tipo de dirección IP.
- continent_code: Código de continente.
- continent_name: Nombre del continente.
- country_code: Código de país.
- country_name: Nombre del país.
- region_code: Código de región.
- region_name: Nombre de la región.
- city: Ciudad.
- zip: Código postal.
- latitude: Latitud del CPA solicitado.
- longitude: Longitud del CPA solicitado.
- location: Localización geográfica.
- geoname_id: ID único de la región geográfica.
- capital: Capital de la región.
- lenguages: Principales idiomas de la región.
- code: Código del idioma.
- name: Nombre del idioma.
- native: Idioma nativo de la región
- country_flag: Bandera del país.
- country_flag_emoji: Bandera de país emoji.
- country_flag_emoji_unicode: Unicode de emoji de bandera de país.
- calling_code: Código de llamada.
- is_eu: is eu
Respuestas de Ejemplo:
Negativa:
{"state":"0","desc":"Invalid IP.","id":"0"}
Positiva:
{ "state":"1", "ip":"152.168.228.179", "type":"ipv4", "continent_code":"SA", "continent_name":"South America", "country_code":"AR","country_name":"Argentina", "region_code":"C", "region_name":"Buenos Aires F.D.", "city":"Buenos Aires", "zip":"C1001", "latitude":-34.611778259277344, "longitude":-58.41730880737305, "location":{ "geoname_id":3435910, "capital":"Buenos Aires", "languages":[ { "code":"es", "name":"Spanish", "native":"Espau00f1ol" }, { "code":"gn", "name":"Guarani", "native":"Avau00f1eu1ebd" } ], "country_flag":"http://assets.ipapi.com/flags/ar.svg", "country_flag_emoji":"ud83cudde6ud83cuddf7", "country_flag_emoji_unicode":"U +1F1E6 U+1F1F7", "calling_code":"54", "is_eu":false } }
Se encuentra a disposición para consultar la documentación técnica, revisar los parámetros de entrada/salida y evaluar las respuestas de la api accediendo a nuestro API-Doc. Así mismo si se registra gratuitamente en nuestro sistema, puede acceder a generar sus Token de Prueba e ingresar a nuestro portal API-Test