InmoDir

Información para desarrolladores

Documentación

Documentación general del servicio de InmoDir para desarrolladores: Parámetros

Al momento de conectar el sitio web de la inmobiliaria con la base de datos de InmoDir se ejecutarán determinados scripts que dependerán del tipo de información que se necesitará mostrar en el sitio web de la inmobiliaria.

En algunos casos será posible indicar la forma en que los datos serán recibidos, incluso también será posible segmentar la información. Y esto será posible mediante la utilización de parámetros, que formarán parte de la URL a utilizar para conectar con el servidor de InmoDir.

  1. Tipos de operación opertype
  2. Tipos de propiedad propertype
  3. Orden de la lista order
  4. Límite de la lista limit

Tipos de operación opertype

En todos los casos donde es necesario indicar el tipo de operación, el parámetro a utilizar es opertype. Sus posibles valores son: 1 ó 2, el primero de ellos es el valor por defecto.

Este parámetro es utilizado por ejemplo con el script annresume, que ofrece la información de la cantidad de anuncios que la inmobiliaria posee. De forma simple, indicando los totales, o de forma compleja, indicando el detalle.

También se utiliza con el script annlist, cuando se pide una lista de anuncios, donde se indica si se desea obtener la lista de anuncios de alquiler o la lista de anuncios de venta.

opertype=1 // Operación de alquiler, renta o arriendo
opertype=2 // Operación de venta

Donde este valor sea necesario pero no se haya indicado, o el valor indicado sea incorrecto, se considerará el valor preestablecido por defecto.

Tipos de propiedad propertype

El parámetro propertype debe ser siempre un valor numérico y cada número corresponde a un determinado tipo de propiedad según la siguiente lista:

opertype=1 // casas/chalets
opertype=2 // monoambientes
opertype=3 // pisos
opertype=4 // lofts
opertype=5 // áticos
opertype=6 // bajos/oficinas
opertype=7 // garajes/trasteros/almacenajes
opertype=8 // naves
opertype=9 // adosados
opertype=10 // terrenos/parcelas

Este parámetro se utiliza con el script annlist, cuando se pide una lista de anuncios, si se desea específicar que la lista de anuncios de un determinado tipo de operación debe mostrar todos los tipos de inmueble se deberá dejar el parámetro propertype sin indicar. En cambio si se desea información de un determinado tipo de inmueble, se deberá indicar el parámetro propertype con un valor válido.

Este dato suele utilizarse también para el script annresume cuando se obtiene un detalle de los anuncios de alquiler o venta de forma detallada. En este caso no como un parámetro pero sí como una variable, que servirá para identificar los resultados de la cantidad de anuncios de cada tipo de inmueble.

Orden de la lista order

En todos los casos donde se solicita una lista de resultados, por ejemplo una lista de anuncios publicados, podrá indicarse el orden en que aparecerán los mismos. Y esto se indicará mediante el parámetro order.

Este parámetro es utilizado por ejemplo con el script annlist, que devuelve la lista de anuncios publicados de la inmobiliaria de un determinado tipo de operación (alquiler o venta). Indicando el tipo de orden, la lista aparecerá ordenada de forma ascendente o descendente. En este script puntual, según la fecha de publicación de los anuncios.

order=desc // Orden descendente (valor por defecto)
order=asc // Orden ascendente

En donde este valor sea necesario pero no se haya indicado, o el valor indicado sea incorrecto, se considerará el valor preestablecido por defecto.

Límite de la lista limit

El parámetro limit indica los límites en que los datos de un listado deben ser devueltos. Está compuesto por dos valores numéricos separados por un punto. El primer valor indicará el punto de partida y el segundo valor la cantidad de resultados a obtener.

Este parámetro es utilizado por ejemplo con el script annlist, que devuelve la lista de anuncios publicados de la inmobiliaria de un determinado tipo de operación (alquiler o venta). Indicando los dos valores del límite, el resultado devolverá una lista basada en los límites establecidos por este parámetro.

Por ejemplo si se quisiera obtener para la página de inicio de la inmobiliaria la información de los tres anuncios de alquiler mas recientes únicamente, se deberá indicar el parámetro limit de esta forma:

limit=0.3 // Mostrará 3 anuncios comenzando desde la posición '0' El anuncio 1, el anuncio 2 y el anuncio 3

Otro ejemplo, también para imprimir una lista de anuncios, en una página de la inmobiliaria que muestra la lista de todos los anuncios de alquiler, si la lista es muy larga y queremos que los resultados no sean de muchos registros por página, para esto se deberían paginar los resultados. Obviamente primero deberíamos obtener el total de resultados, luego dividirlo en la cantidad de resultados por página que deseamos mostrar y así obtener un valor que utilizaremos mediante un ciclo para generar los enlaces a las páginas de resultados. De esta forma, cada enlace cargará la página con un valor diferente en el parámetro limit.

Por ejemplo si quisieramos mostrar no mas de 10 registros por página, los enlaces para paginar los resultados deberían llevar los siguientes valores en el parámetro limit:

limit=0.10 // Mostrará 10 anuncios comenzando desde la posición '0' El anuncio 1, el anuncio 2, ... hasta el anuncio 9
limit=10.10 // Mostrará 10 anuncios comenzando desde la posición '10' El anuncio 11, el anuncio 12, ... hasta el anuncio 19
limit=20.10 // Mostrará 10 anuncios comenzando desde la posición '20' El anuncio 21, el anuncio 22, ... hasta el anuncio 29
// ...y así sucesivamente según la cantidad de enlaces a mostrar.