Detalle de la API

A continuación podrá consultar la información, comercial, técnica y funcional de la API seleccionada.

Validate_Address

Validation and standardization Address

Proveedor: Sysworld

Fecha: 2019-05-23 09:29:29


fintech, identity, notifications, productivity, security, socialnetworks

automotive, coorp, fintech, gov, insurance, pymes, retail, tech
$ Incluida.
       
  • ID : 95a6ec9b08445e1ddaf4054fed80f811
  • Contexto : validations/address/validate_simple
  • Estado : Activa

La herramienta de Validación de direcciones es la solución informática para validar y normalizar las direcciones ingresadas.

Años de trayectoria brindando soluciones al mundo empresarial y financiero, nos han permitido detectar una problemática a la hora de las direcciones almacenadas de los clientes quedando el dato sin normalizar y que perjudican la comunicación con el destinatario o la sectorización de acuerdo a su región para una mejor atención.

Gracias a esta herramienta podrá validar la dirección ingresada y obtener datos adicionales como el barrio, el código postal, las diferentes normalizaciones de la dirección, latitud y longitud, etc.

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/validations/address/validate_simple

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.
  • address: Dirección a validar (calle, ciudad, provincia).
  • country: País de la dirección 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/validations/address/validate_simple?token-susc=TOKENSUSC&token-api=TOKENAPI&address=Montevideo&country=Argentina&internalid=40

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.
  • desc: Descripción del parámetro "state" recibido.
  • data: Conjunto de información recibida.
    • results: Datos resultantes de la consulta realizada.
      • address_components: Array que incluye datos normalizados de la dirección consultada.(número, calle, barrio, ciudad, provincia, país, código postal)
        • long_name: Nombre completo.
        • short_name: Nombre abreviado.
        • types: Tipo de componente de la dirección consultada.
      • formatted_address: Dirección normalizada.
      • geometry: Array que incluye diferentes coordenadas de la ubicación.
      • location: Localización.
        • lat: Latitud.
        • lng: Longitud.
      • location_type: Tipo de localización.
      • viewport: Puntos limítrofes.
        • northeast: Límite noreste.
        • southwest: Límite suroeste.
      • place_id: Identificación que se puede utilizar en Google Maps para identificar una dirección.
      • types: Tipo de dirección.
    • status: Dato del estado de la validación realizada.
  • id_internal: ID interno ingresado por el cliente.

Respuestas de Ejemplo:

Negativa:

{"state":"0","desc":"invalid address.", "id_internal":"0"}

Positiva:

{ "state": "1", "data": { "results": [ { "address_components": [ { "long_name": "1470", "short_name": "1470", "types": [ "street_number" ] }, { "long_name": "Cuareim", "short_name": "Cuareim", "types": [ "route" ] }, { "long_name": "Montevideo", "short_name": "Montevideo", "types": [ "locality", "political" ] }, { "long_name": "B", "short_name": "B", "types": [ "administrative_area_level_2", "political" ] }, { "long_name": "Departamento de Montevideo", "short_name": "Departamento de Montevideo", "types": [ "administrative_area_level_1", "political" ] }, { "long_name": "Uruguay", "short_name": "UY", "types": [ "country", "political" ] }, { "long_name": "11100", "short_name": "11100", "types": [ "postal_code" ] } ], "formatted_address": "Cuareim 1470, 11100 Montevideo, Departamento de Montevideo, Uruguay", "geometry": { "location": { "lat": -34.9035698, "lng": -56.1903516 }, "location_type": "ROOFTOP", "viewport": { "northeast": { "lat": -34.9022208197085, "lng": -56.1890026197085 }, "southwest": { "lat": -34.9049187802915, "lng": -56.1917005802915 } } }, "place_id": "ChIJK2ll8DKAn5UR1Lo4m9WV4Bg", "types": [ "embassy", "establishment", "point_of_interest" ] } ], "status": "OK" }, "id_internal": "0" }

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:

  • Crear una
    Cuenta Gratis

  • Probar las APIS
    sin créditos

  • Aprobar la
    suscripción y pagar