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

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.
• province: Nombre de la provincia 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/province?token-susc=TOKENSUSC&token-api=TOKENAPI&province=Buenos%20Aires&internalid=93

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 provincia.
  • category: Tipo de entidad.
  • latitude: Latitud donde se ubica la provincia.
  • longitude: Longitud donde se ubica la provincia.
  • source: Fuente de información.
  • id_province: ID de la provincia.
  • iso_id: Identificador ISO 3166-2.
  • iso_name: Nombre ISO.
  • name: Nombre de la provincia.
  • description: Nombre completo de la provincia.
• 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":"22","category":"Ciudad Autónoma","latitude":"-34.6144934119689","longitude":"-58.4458563545429","source":"IGN","id_province":"02","iso_id":"AR-C","iso_name":"Ciudad Autónoma de Buenos Aires","name":"Ciudad Autónoma de Buenos Aires","description":"Ciudad Autónoma de Buenos Aires"},{"id":"23","category":"Provincia","latitude":"-36.6769415180527","longitude":"-60.5588319815719","source":"IGN","id_province":"06","iso_id":"AR-B","iso_name":"Buenos Aires","name":"Buenos Aires","description":"Provincia 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: