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/locality

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.
• locality: Localidad 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://cont1-virtual1.certisend.com/web/container/api/v1/database/data/ar/geo/locality?token-susc=TOKENSUSC&token-api=TOKENAPI&locality=CABA&internalid=94

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 encontrada.
  • category: Categoría de la localidad encontrada.
  • latitude: Latitud donde se ubica la localidad encontrada.
  • longitude: Longitud de la localidad encontrada.
  • id_region: ID de la región de la localidad encontrada.
  • region_name: Nombre de la región de la localidad encontrada.
  • source: Fuente de información.
  • id_loc: ID de la localización de la localidad encontrada.
  • id_censal_location: ID de la locación censal de la localidad encontrada.
  • name_censal_location: Nombre de la locación censal.
  • id_municipality: ID de la municipalidad de la localidad encontrada.
  • name_municipality: Nombre de la municipalidad de la localidad encontrada.
  • name: Denominación oficial de la localidad encontrada.
  • id_province: ID de la provincia de la localidad encontrada.
  • province_name: Nombre de la provincia de la localidad encontrada.
• 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":"1033","category":"Entidad","latitude":"-28.1243914662106","longitude":"-67.4981013989976","id_region":"10105","region_name":"Tinogasta","source":"INDEC","id_loc":"10105050001","id_censal_location":"10105050","name_censal_location":"Copacabana","id_municipality":"100231","name_municipality":"Tinogasta","name":"COPACABANA","id_province":"10","province_name":"Catamarca"},{"id":"1034","category":"Entidad","latitude":"-28.1243914662106","longitude":"-67.4981013989976","id_region":"10105","region_name":"Tinogasta","source":"INDEC","id_loc":"10105050002","id_censal_location":"10105050","name_censal_location":"Copacabana","id_municipality":"100231","name_municipality":"Tinogasta","name":"LA PUNTILLA","id_province":"10","province_name":"Catamarca"},{"id":"1212","category":"Localidad simple","latitude":"-30.6113486219317","longitude":"-64.5555688574614","id_region":"14049","region_name":"Ischilín","source":"INDEC","id_loc":"14049040000","id_censal_location":"14049040","name_censal_location":"Copacabana","id_municipality":"","name_municipality":"","name":"COPACABANA","id_province":"14","province_name":"Córdoba"},{"id":"1290","category":"Localidad simple","latitude":"-31.3931049014855","longitude":"-64.5635652642982","id_region":"14091","region_name":"Punilla","source":"INDEC","id_loc":"14091030000","id_censal_location":"14091030","name_censal_location":"Cabalango","id_municipality":"142469","name_municipality":"Cabalango","name":"CABALANGO","id_province":"14","province_name":"Córdoba"},{"id":"2246","category":"Localidad simple","latitude":"-22.1671932548934","longitude":"-66.0247356350832","id_region":"38077","region_name":"Santa Catalina","source":"INDEC","id_loc":"38077110000","id_censal_location":"38077110","name_censal_location":"Yoscaba","id_municipality":"386133","name_municipality":"Cieneguillas","name":"YOSCABA","id_province":"38","province_name":"Jujuy"},{"id":"2808","category":"Localidad simple","latitude":"-26.5379470287742","longitude":"-53.9437324956095","id_region":"54112","region_name":"San Pedro","source":"INDEC","id_loc":"54112010000","id_censal_location":"54112010","name_censal_location":"Cruce Caballero","id_municipality":"540504","name_municipality":"San Pedro","name":"CRUCE CABALLERO","id_province":"54","province_name":"Misiones"},{"id":"3056","category":"Localidad simple","latitude":"-24.8260406674686","longitude":"-64.1855790667322","id_region":"66007","region_name":"Anta","source":"INDEC","id_loc":"66007140000","id_censal_location":"66007140","name_censal_location":"Piquete Cabado","id_municipality":"660028","name_municipality":"Joaquín V. González","name":"PIQUETE CABADO","id_province":"66","province_name":"Salta"},{"id":"3498","category":"Localidad simple","latitude":"-30.9229849971234","longitude":"-60.0481154588667","id_region":"82035","region_name":"Garay","source":"INDEC","id_loc":"82035040000","id_censal_location":"82035040","name_censal_location":"Saladero Mariano Cabal","id_municipality":"822560","name_municipality":"Saladero Mariano Cabal","name":"SALADERO MARIANO CABAL","id_province":"82","province_name":"Santa Fe"},{"id":"3575","category":"Localidad simple","latitude":"-31.1039907773825","longitude":"-60.7271526484511","id_region":"82063","region_name":"La Capital","source":"INDEC","id_loc":"82063040000","id_censal_location":"82063040","name_censal_location":"Cabal","id_municipality":"822966","name_municipality":"Cabal","name":"CABAL","id_province":"82","province_name":"Santa Fe"},{"id":"4104","category":"Entidad","latitude":"-34.6168254996915","longitude":"-58.443603110353","id_region":"02042","region_name":"Comuna 6","source":"INDEC","id_loc":"02042010001","id_censal_location":"02000010","name_censal_location":"Ciudad Autónoma de Buenos Aires","id_municipality":"","name_municipality":"","name":"CABALLITO","id_province":"02","province_name":"Ciudad Autónoma de Buenos Aires"}]],"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: