Ofinet - Software Corretaje Propiedades y Administracion de Arriendos, Sistema de corretaje

Uso de Nuestra Api

En esta sección te mostraremos como se debe usar nuestra API para poder integrarse con tu software

Nuestra API está en una plataforma segura, que pedirá datos de autenticación y devolverá la información que tengas en nuestro sistema de corretaje

¿Cómo integrarse a nuestra API?

Una vez tengas instalada tu aplicación de corretaje provista por OFINET, tendrás acceso a una API que te entregará la información de:

Comunas
Tipo de Inmuebles
Operaciones disponibles
Listado de Propiedades
Detalle de Propiedad

La API siempre será de la siguiente manera:


                                                    http://tudominio/api/controlador

Ejemplo:


                                                    curl --location --request GET 'http://www.ofinetservi.cl/demomeli/api/Comuna'

Para el correcto funcionamiento de la API se te proporcionará un TOKEN para al autorización, la cual trabaja por Bearer. Un ejemplo de la llamada con el token sería de la siguiente manera si el token es FA8898C410664B4E8D704AF584088796:


                                                    curl --location --request GET 'http://www.ofinetservi.cl/demomeli/api/Comuna' --header 'Authorization: Bearer FA8898C410664B4E8D704AF584088796'

Si la autorización del TOKEN es incorrecta se devolverá el siguiente JSON:

Finalmente, todas las APIs que se verán a continuación, tienen la key responseCode la que indicará con un 0 que no tiene error y con un número distinto a 0, que significará que tiene un error. El tag con la descripción del error será ErrorMensaje

Ejemplo de éxito:

Ejemplo de error:

API COMUNAS

Con nuestro sistema de corretaje de propiedades, estará ingresando propiedades por lo que estás estarán asociadas a una comuna y desde luego a una región. La API de comunas trabaja por Método GET, devolverá solo las comunas que esten asociadas a propiedades VIGENTES

La siguiente instrucción generará la llamada al API de Comunas:


                                                    curl --location --request GET 'http://www.ofinetservi.cl/demomeli/api/Comuna' --header 'Authorization: Bearer FA8898C410664B4E8D704AF584088796'

El Resultado esperado es el siguiente:

API TIPO INMUEBLES

Con nuestro sistema de corretaje de propiedades, estará ingresando propiedades por lo que estás estarán asociadas a un TIPO DE INMUEBLES. La API de Tipo de Inmuebles trabaja por Método GET, devolverá solo los Tipos de Inmuebles que esten asociadas a propiedades VIGENTES

La siguiente instrucción generará la llamada al API de Tipo Inmuebles:


                                                    curl --location --request GET 'http://www.ofinetservi.cl/demomeli/api/Categoria' --header 'Authorization: Bearer FA8898C410664B4E8D704AF584088796'

El Resultado esperado es el siguiente:

API OPERACIÓN

Las propiedades ingresadas estarán asociadas a una OPERACIÓN. La API de Operaciones trabaja por Método GET, devolverá solo las Operaciones habilitadas en su dominio

La siguiente instrucción generará la llamada al API de Operaciones:


                                                    curl --location --request GET 'http://www.ofinetservi.cl/demomeli/api/Operacion' --header 'Authorization: Bearer FA8898C410664B4E8D704AF584088796'

El Resultado esperado es el siguiente:

API PROPIEDADES

Lista las propiedades ingresadas en nuestro sistema de corretaje de propiedades. La API de Propiedades trabaja por Método POST, se debe envíar un json con los filtros y devolverá solo las propiedades coincidentes con estos.

La siguiente instrucción generará la llamada al API de Propiedades:


                                                    curl --location --request POST 'http://www.ofinetservi.cl/demomeli/api/propiedades' --header 'Authorization: Bearer FA8898C410664B4E8D704AF584088796' --header 'Content-Type: application/json' 
                                                    --data-raw '{
                                                    "Operacion": 1,
                                                    "Region": -1,
                                                    "Tipo": "-1",
                                                    "Comuna": -1,
                                                    "TipoMoneda": 1,
                                                    "ValorDesde": 0,
                                                    "ValorHasta": 0,
                                                    "SupDesde": 0,
                                                    "SupHasta": 0,
                                                    "DormDesde": 0,
                                                    "DormHasta": 0,
                                                    "Condominio": -1,
                                                    "Ordenamiento": "Reciente",
                                                    "RegPag": 9,
                                                    "NumPag": 1
                                                  }'

El Resultado esperado es el siguiente:

El JSON que se debe enviar por Método POST es el siguiente:

La explicación de los Campos del JSON es el siguiente:

CAMPO	TIPO	DESCRIPCIÓN
Operacion	Numérico	Código de Operación, obtenido de api api/operacion: Ejemplo: 1 = VENTA 2 = ARRIENDO
Region	Numérico	Código de Región, obtenido de api api/comuna
Tipo	Texto	Código de Categoria, obtenido de api api/categoria, puede ir concatenado por commas (,) Ejemplo: CA = CASA Ejemplo con concatenación: CA, DE Lo anterior filtrará por casas y departamentos
Comuna	Numérico	Código de Comuna, obtenido de api api/comuna
TipoMoneda	Numérico	Código de Moneda, valores disponibles: 1 = Valor Pesos 2 = Valor UF
ValorDesde	Numérico	Indica el valor desde de la propiedad, puede ser 0
ValorHasta	Numérico	Indica el valor hasta de la propiedad, puede ser 0
SupDesde	Numérico	Indica el valor desde de la superficie (m2 o hectárea) de la propiedad, puede ser 0
SupDesde	Numérico	Indica el valor hasta de la superficie (m2 o hectárea) de la propiedad, puede ser 0
DormDesde	Numérico	Indica la cantidad de habitaciones de la propiedad, puede ser 0
DormDesde	Numérico	Indica la cantidad de habitaciones de la propiedad, puede ser 0
Condominio	Numérico	Indica si la propiedad esta o no en Condominio, valores posibles: -1 = Cualquiera 1 = Esta en condominio 2 = No esta en condominio
Ordenamiento	Alphanúmerico	Indica por los valores posibles de ordenamiento, los valores son: Reciente PrecioMayor PrecioMenor
RegPag	Númerico	Indica Registros por página a Mostrar, valor por defecto 0
NumPag	Númerico	Indica el número de página a mostrar 0

API DETALLE PROPIEDAD

Está API obtiene el Detalle de la propiedad, con todos los campos necesarios para mostrar información completa. La API de Detalle de Propiedad trabaja por Método GET, recibiendo un json con los filtros y devolverá solo las propiedades coincidentes con los filtros enviados.

La siguiente instrucción generará la llamada al API de Detalle de Propiedad:


                                                    curl --location --request GET 'http://www.ofinetservi.cl/demomeli/api/propiedad/CodigoPropiedad' --header 'Authorization: Bearer FA8898C410664B4E8D704AF584088796'

Donde CodigoPropiedad es un número obtenido de la lista de la api/propiedades, de la key NroProp


                                                    curl --location --request GET 'http://www.ofinetservi.cl/demomeli/api/propiedad/205' --header 'Authorization: Bearer FA8898C410664B4E8D704AF584088796'

El Resultado esperado es el siguiente, despúes de la llamada anterior:

Ver planes

Somos una empresa formada por expertos en el desarrollo e implementación de software para Internet.
Nuestra empresa ha creado aplicaciones a medida para sus clientes, y asesoría computacional de alto nivel, desde el año 2006.

Ver Clientes

Nuestros Clientes avalan nuestra trayectoria, depositando su confianza en los productos informáticos y sitios web a medida a su entera satisfacción. Contamos con Mesa de Ayuda para responder a sus inquietudes cada vez que lo requieran.