API´s Dinámicas

Como realizar una petición

Las API´s dinámicas necesitan parámetros, que corresponden al tipo de filtros que se envían, estas son necesarias para que el servidor pueda realizar la búsqueda, de caso contrario la respuesta puede devolvernos un error.

A continuación, se muestra el un ejemplo de una petición con la herramienta POSTMAN de la consulta dinámica “Valores catastrales por años”.

En la URI poner http://rppccolima.col.gob.mx:8000/SINSAC/api/valoresCatastrales

Seleccionar la opción de "Body"

Agregar un objeto JSON con los siguientes parámetros:

opcion
las opciones se refiere al tipo de valor catastral que deseamos recuperar
- valor_catastral
- valor_terreno
- valor_construccion
- superficie_terreno
- superficie_construccion
fechaInicial
La fecha inicial, solo se permite años
fechaFinal
La fecha final, puede ser igual o mayor que la fecha inicial

El servidor nos enviara la respuesta correspondiente a los parámetros enviados.

Si la fecha final es inferior a la fecha final, nos devolverá datos sin cantidades como se muestra a continuación.

Si no se envían los parámetros correctamente, o si se hace la petición sin parámetros, el servidor nos devolverá un error.

URI Dinámicas

URI

http://rppccolima.col.gob.mx:8000/SINSAC/api/valoresCatastrales

Parámetros

opcion
las opciones se refiere al tipo de valor catastral que deseamos recuperar
- valor_catastral
- valor_terreno
- valor_construccion
- superficie_terreno
- superficie_construccion
fechaInicial
La fecha inicial, solo se permite años
fechaFinal
La fecha final, puede ser igual o mayor que la fecha inicial

URI

http://rppccolima.col.gob.mx:8000/SINSAC/api/valoresCatastralesV2

Parámetros

opcion
las opciones se refiere al tipo de valor catastral que deseamos recuperar
- valor_catastral
- valor_terreno
- valor_construccion
- superficie_terreno
- superficie_construccion
tipo_fecha
- fecha_completa
  Formato : "aaaa-mm-dd"
- fecha_anios
  Formato : "aaaa"
fecha_inicio
fecha_fin

Ejemplo fecha completa

{ "opcion": "valor_catastral", "tipo_fecha": "fecha_completa", "fecha_inicio": "2020-01-01", "fecha_fin": "2020-12-12" }

Ejemplo fecha solo años

{ "opcion": "valor_catastral", "tipo_fecha": "fecha_anios", "fecha_inicio": "2010", "fecha_fin": "2099" }

URI

http://rppccolima.col.gob.mx:8000/SINSAC/api/dinamicaConsulta

Parámetros

opcion
las opciones se refiere al tipo de valor catastral que deseamos recuperar
- valor_catastral
- valor_terreno
- valor_construccion
- superficie_terreno
- superficie_construccion
tiempo
- false
  No se requiere ningun otro parámetro
- true
  Agregar tipo de fecha y rantgo de fechas
- tipo_fecha
  - fecha_completa
    Formato : "aaaa-mm-dd"
  - fecha_anios
    Formato : "aaaa"
- fecha_inicio
- fecha_fin

municipioConsulta
poblacionConsulta
coloniaConsulta

Si no se requiere estas parámetros se debe enviar como "false", en caso de requerir, enviar "true" como parametro, ademas de agregar el nombre del parámetro como se muestra acontinuación.

colonia : "nombre colonia"
poblacion : "nombre poblacion"
colonia : "nombre colonia"

Para obtener los catálagos de Municipios, poblaciones y colonias ver la documentación de API Integradas.

Ejemplo fecha solo años

{ "tiempo": "true", "tipo_fecha": "fecha_anios", "fecha_inicio": "2016", "fecha_fin": "2020", "municipioConsulta": "false", "poblacionConsulta": "false", "coloniaConsulta": "false", "opcion": "valor_catastral" }

Ejemplo solo con municipio sin años

{ "tiempo": "false", "municipioConsulta": "true", "poblacionConsulta": "false", "coloniaConsulta": "false", "municipio": "ARMERIA", "opcion": "valor_catastral" }

Ejemplo con todos los parámetros

{ "tiempo": "true", "tipo_fecha": "fecha_completa", "fecha_inicio": "2020-01-01", "fecha_fin": "2020-01-12", "municipioConsulta": "true", "poblacionConsulta": "true", "coloniaConsulta": "true", "municipio": "COLIMA", "poblacionesCheck": "", "poblacion": "COLIMA", "colonia": "CENTRO", "opcion": "valor_terreno" }