Detalle de la API

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

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

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.
• street: Nombre o parte del nombre de la calle. (Obligatorio)
  
• category: Tipo de calle.
• province: Nombre de la provincia.
• department: Nombre del departamento.
• census_location: Nombre de la localidad censal.
• 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/georef/street?token-susc=TOKENSUSC&token-api=TOKENAPI&street=9%20de%20julio&category=calle&province=buenos%20aires&department=ca%C3%B1uelas&census_location=m%C3%A1ximo%20paz&internalid=5

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.
• data: Conjunto de información recibida.
  • streets: Calles encontradas y su información.
    • altura: Longitud de la calle encontrada
      
      • fin: Últimos números de la calle.
        
        • derecha: Último número del lado derecho.
        • izquierda: Último número del lado izquierdo.
      • start: Primeros números de la calle.
        • derecha: Primer número del lado derecho.
        • izquierda: Primer número del lado izquierdo.
    • categoría: Tipo de calle.
    • departamento: Departamento donde se ubica la calle.
      • id: ID único del departamento.
      • nombre: Nombre del departamento.
    • id: ID único de la calle encontrada.
    • localidad_censal: Localidad censal donde se ubica la calle. 
      • id: ID único de la localidad censal.
      • nombre: Nombre de la localidad censal.
    • nombre: Nombre de la calle encontrada.
    • nomenclatura: Definición completa de la calle compuesta por su nombre, departamento y provincia.
    • provincia: Provincia donde se ubica la calle encontrada.
      • id: ID único de la provincia.
      • nombre: Nombre de la provincia.
  • quantity: Cantidad de registros encontrados.
  • parameters: Parámetros usados en la consulta.
    • categoría: Tipo de calle especificado (category).
    • departamento: Departamento especificado (department).
    • localidad_censal: Localidad censal especificada (census_location).
    • nombre: Calle consultada (street).
    • provincia: Provincia especificada (province).
  • amount: Total de resultados encontrados.
• internalid: ID interno ingresado por el cliente.

Respuestas de Ejemplo:

Negativa:

{"state":"0","desc":"street not found.","internalid":"0"}

Positiva:

{"state":"1","data":[{"streets":[{"altura":{"fin":{"derecha":400,"izquierda":399},"start":{"derecha":2,"izquierda":1}},"categoria":"CALLE","departamento":{"id":"06134","nombre":"Cañuelas"},"id":"0613405000020","localidad_censal":{"id":"06134050","nombre":"Máximo Paz"},"nombre":"9 DE JULIO","nomenclatura":"9 DE JULIO, Cañuelas, Buenos Aires","provincia":{"id":"06","nombre":"Buenos Aires"}}],"quantity":1,"start":0,"parameters":{"categoria":"calle","departamento":"cañuelas","localidad_censal":"máximo paz","nombre":"9 de julio","provincia":"buenos aires"},"amount":1}],"internalid":"5"}

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: