Detalle de la API

Para poder utilizar esta API se debe realizar una llamada con un método GET conformándose por:

• Endpoint: https://cont1-virtual1.certisend.com/web/container/api/v1/database/data/ar/geo/settlements

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.
• settlement: Asentamiento a validar.
• 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://cont1-virtual1.certisend.com/web/container/api/v1/database/data/ar/geo/settlements?token-susc=TOKENSUSC&token-api=TOKENAPI&settlement=12&internalid=95

Una vez realizada la llamada van a recibir los siguientes parámetros:

• state: Tendrá el valor 0:(desconocido/error.), 1:(ok/validado correctamente.).
• desc: Descripción del parámetro "state" recibido.
• data: Conjunto de información recibida.
  • id: ID de la localidad del asentamiento.
  • category: Nombre de la localidad del asentamiento.
  • latitude: Latitud donde se ubica el asentamiento encontrado.
  • longitude: Longitud donde se ubica el asentamiento encontrado.
  • id_region: ID de la región del asentamiento.
  • region_name: Nombre de la región del asentamiento.
  • source: Fuente de información.
  • id_loc: ID de la localidad del asentamiento.
  • id_censal_location: ID de la localidad censal.
  • name_censal_location: Nombre de la localidad censal.
  • id_municipality: ID de la municipalidad del asentamiento.
  • name_municipality: Nombre de la municipalidad del asentamiento.
  • name: Denominación oficial de la municipalidad del asentamiento.
  • id_province: ID de la provincia del asentamiento.
  • province_name: Nombre de la provincia del asentamiento.
• id_internal: ID interno ingresado por el cliente.

Respuestas de Ejemplo:

Negativa:

{"state":"0","desc":"code not found.","id_internal":"0"}

Positiva:

{"state":"1","data":[[{"id":"579","category":"Localidad simple","latitude":"-35.607730780146","longitude":"-60.9182929927645","id_region":"06588","region_name":"9 de Julio","source":"INDEC","id_loc":"06588030000","id_censal_location":"06588030","name_censal_location":"12 de Octubre","id_municipality":"060588","name_municipality":"9 de Julio","name":"12 DE OCTUBRE","id_province":"06","province_name":"Buenos Aires"},{"id":"2659","category":"Localidad simple","latitude":"-33.1912015360595","longitude":"-68.2809624398751","id_region":"50112","region_name":"Santa Rosa","source":"INDEC","id_loc":"50112010000","id_censal_location":"50112010","name_censal_location":"Barrio 12 de Octubre","id_municipality":"500112","name_municipality":"Santa Rosa","name":"BARRIO 12 DE OCTUBRE","id_province":"50","province_name":"Mendoza"}]],"id_internal":""}

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

Definición Técnica de la API: