InmoDir

Información para desarrolladores

Documentación

Documentación general del servicio de InmoDir para desarrolladores: Tipos de conexión remota

Existen varias alternativas para que desde la página web de una inmobiliaria se pueda conectar de forma remota con el servidor de InmoDir y así obtener la información necesaria para mostrar en el sitio web propio de la inmobiliaria.

Aqui se brindarán tres métodos diferentes a modo de ejemplo, utilizando en los tres casos el lenguaje PHP (Hypertext Pre-processor) ya que es un lenguaje de uso general de código del lado del servidor de libre licencia y soportado por casi todos los sistemas operativos, principalmente por el sistema LINUX. Este último, utilizado como el sistema operativo por casi el 90% de los servidores de Internet.

  1. Ejemplos de conexión remota con PHP
  2. Ejemplos de conexión remota: cURL
  3. Ejemplos de conexión remota: file_get_contents()
  4. Ejemplos de conexión remota: fopen()

Ejemplos de conexión remota con PHP

Tal como se indica en los ejemplos de scripts con datos tabulados o con JSON para obtener una lista de anuncios inmobiliarios, para obtener información de un determinado anuncio o incluso de sus fotografías, para hacer correr el script y obtener los resultados necesarios nos tenemos que conectar a una URL específica.

Dependiendo del tipo de script, es muy posible que la URL de conexión sea algo así: http://es.inmodir.com/lab/tab/ann_data/. Y necesitará uno o mas parámetros, donde uno de ellos será sin dudas el parámetro icode, que corresponde al código único de la inmobiliaria y otros parámetros mas que dependerán del tipo de información que se necesitará obtener y opcionalmente de la forma en que tal información sea requerida.

En los tres ejemplos de scripts que se indican a continuación, la función consistirá en conectarse al servidor de InmoDir de un determinado país, para obtener información de un anuncio específico de una inmobiliaria indicando tres valores de entrada mediante las variables $inmoscript_url, $inmoscript_icode y $inmoscript_moreparams que podrás observar dentro del código fuente indicados al comienzo donde pone "Valores". Al final de cada script, se pedirá que se almacene toda la información obtenida en la variable $inmosdata y, mediante el constructor echo, se imprimirá en la pantalla.

Recomendamos aquí echar un vistazo rápido sin tomar los ejemplos para hacer una prueba ahora mismo, ya que existen ejemplos de scripts similares pero mas completos en otras secciónes de esta misma área de desarrolladores.

En los tres siguientes métodos, observa que antes de aplicar la función de conexión, se forzará a interpretar el resultado según la codificación UTF-8, esto evitará problemas con los acentos y apóstrofes.

Conectarse y obtener los datos utilizando las librerías de cURL

<?php
/*
 * Obtener de forma remota con cURL
 * la lista de anuncios de mi cliente en InmoDir.
 */

/* Valores. */
$inmoscript_url = "http://es.inmodir.com/lab/tab/ann_data/?icode="; // url del script.
$inmoscript_icode = "12345678901234567890123456789012"; // iCode de tu cliente.
$inmoscript_moreparams = "&acode=12349874563217531596548521346798"; // aCode del anuncio.
/* Funciones. */
$ch = curl_init($inmoscript_url.$inmoscript_icode.$inmoscript_moreparams);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
if(curl_exec($ch) === false)
{
 echo'Curl error: '.curl_error($ch);
}
 else
{
 curl_setopt($ch, CURLOPT_URL, $inmoscript_url.$inmoscript_icode.$inmoscript_moreparams);
 curl_setopt($ch, CURLOPT_POST, 1);
 curl_setopt($ch, CURLOPT_ENCODING, "UTF-8");
 $inmodata = curl_exec($ch); // Ejecutar  
 curl_close($ch); // Cerrar  
 /* Imprimimos para verificar. */
 echo$inmodata;
}
?>

Conectarse y obtener los datos utilizando la función file_get_contents()

<?php
/*
 * Obtener de forma remota con la función file_get_contents
 * la lista de anuncios de mi cliente en InmoDir.
 */

/* Valores. */
$inmoscript_url = "http://es.inmodir.com/lab/tab/ann_data/?icode="; // url del script.
$inmoscript_icode = "12345678901234567890123456789012"; // iCode de tu cliente.
$inmoscript_moreparams = "&acode=12349874563217531596548521346798"; // aCode del anuncio.
/* Funciones. */
$opts = array(
  'http'=>array(
   'method'=>"GET",
   'header'=>implode("\r\n", array('Content-type: text/plain; charset=utf-8'))
  )
);
$context = stream_context_create($opts);
$inmodata = file_get_contents($inmoscript_url.$inmoscript_icode.$inmoscript_moreparams,false, $context);  
/* Imprimimos para verificar. */
echo$inmodata;
?>

Conectarse y obtener los datos utilizando la función fopen()

<?php
/*
 * Obtener de forma remota con fopen
 * la lista de anuncios de mi cliente en InmoDir.
 */

/* Valores. */
$inmoscript_url = "http://es.inmodir.com/lab/tab/ann_data/?icode="; // url del script.
$inmoscript_icode = "12345678901234567890123456789012"; // iCode de tu cliente.
$inmoscript_moreparams = "&acode=12349874563217531596548521346798"; // aCode del anuncio.
/* Funciones. */
$opts = array(
  'http'=>array(
   'method'=>"GET",
   'header'=>implode("\r\n", array('Content-type: text/plain; charset=utf-8'))
  )
);
$context = stream_context_create($opts);
$inmodata = fopen($inmoscript_url.$inmoscript_icode.$inmoscript_moreparams, "r", false, $context);
$inmodata = stream_get_contents($inmodata);
/* Imprimimos para verificar. */
echo$inmodata;
?>