InmoDir

Información para desarrolladores

Documentación

Documentación general del servicio de InmoDir para desarrolladores: Mensajes de error utilizando JSON

Al momento de conectar el sitio web de la inmobiliaria con la base de datos de InmoDir para obtener información mediante la utilización de JSON, se ejecutarán determinados scripts que devolverán diferente información. Los scripts están preparados para funcionar incluso si algún parámetro no se ha indicado de la forma correcta implementando en estos casos automáticamente sus valores por defecto, pero si ocurriera un caso que imposibilita devolver los resultados obtendremos un mensaje de error.

Introducción

Un caso común puede ser indicar de forma incorrecta el icode de la inmobiliaria, o el acode de un anuncio y nos gustará saber si por ejemplo el anuncio solicitado no existe. O puede ocurrir que un visitante del sitio web de la inmobiliaria de nuestro cliente acceda a una página con un enlace que tenía previamente agendado con el parámetro de un anuncio que ya no existe. En estos casos se recibirá un código de error que nos servirá para colocar, en base a ese código, un mensaje personalizado. Algo mucho mejor a que aparezca una página en blanco.

Mensajes de error utilizando JSON

A continuación una lista de los códigos de error y su significado cuando se utiliza conexión remota al servidor de InmoDir utilizando scripts para la obtención de datos con JSON.

Recordar que utilizando este método, en la información devuelta por el servidor de InmoDir siempre habrá al menos dos variables importantes: optnumber y opterror además de las variables relacionadas con el resultado, por ejemplo: optdata. Si ocurriese un error, lo mas probable es que la variable que indica la cantidad de registros obtenidos sea optnumber=-1 (el número uno, en negativo) y la variable opterror=xxxx. Donde "xxxx" será el número que nos indicará un número de error que servirá para identificar el caso.

Una buena manera de ordenar el código podría ser dependiendo de la condición si el valor obtenido dentro de la variable optnumber < 0 entonces habrá un error, si en cambio optnumber == 0, entonces no habrá un error pero no se encontraron registros, o si por el contrario optnumber > 0, entonces habrá registros.

$opterror=101

Script adslist: Llegó a ejecutarse el script pero hubo un error no definido, posiblemente falte algún parámetro el cual no puede ser reemplazado con su valor por defecto.

$opterror=102

Script adslist: Inmobiliaria inexistente, no definida o icode incorrecto.
Verificar icode.

$opterror=103

Script adslist: Inmobiliaria no tiene activado el servicio de nube. Ni de forma temporal, que lo activa el usuario desarrollador, ni de forma definitiva porque la inmobiliaria no posee un plan de pago. O puede ser el primer caso y el período de prueba ha expirado.

$opterror=201

Script adsdata: Llegó a ejecutarse el script pero hubo un error no definido, posiblemente falte algún parámetro el cual no puede ser reemplazado con su valor por defecto.

$opterror=202

Script adsdata: Inmobiliaria inexistente, no definida o icode incorrecto.
Verificar icode.

$opterror=203

Script adsdata: Inmobiliaria no tiene activado el servicio de nube. Ni de forma temporal, que lo activa el usuario desarrollador, ni de forma definitiva porque la inmobiliaria no posee un plan de pago. O puede ser el primer caso y el período de prueba ha expirado.

$opterror=204

Script adsdata: Código del anuncio incorrecto.
Verificar acode.

$opterror=205

Script adsdata: Código del anuncio inexistente.
Verificar acode.

$opterror=206

Script adsdata: Código del anuncio inexistente o incorrecto.
Verificar acode, posiblemente no esté bien definido o ni se haya indicado un valor numérico.

$opterror=207

Script adsdata: El anuncio no existe mas, ha sido desactivado o ha expirado.

$opterror=208

Script adsdata: El anuncio no pertenece a la inmobiliaria indicada.

$opterror=301

Script adspics: Llegó a ejecutarse el script pero hubo un error no definido, posiblemente falte algún parámetro el cual no puede ser reemplazado con su valor por defecto.

$opterror=302

Script adspics: Inmobiliaria inexistente, no definida o icode incorrecto.
Verificar icode.

$opterror=303

Script adspics: Inmobiliaria no tiene activado el servicio de nube. Ni de forma temporal, que lo activa el usuario desarrollador, ni de forma definitiva porque la inmobiliaria no posee un plan de pago. O puede ser el primer caso y el período de prueba ha expirado.

$opterror=304

Script adspics: Código del anuncio incorrecto.
Verificar acode.

$opterror=305

Script adspics: Código del anuncio inexistente.
Verificar acode.

$opterror=306

Script adspics: Código del anuncio inexistente o incorrecto.
Verificar acode, posiblemente no esté bien definido o ni se haya indicado un valor numérico.

$opterror=307

Script adspics: El anuncio no existe mas, ha sido desactivado o ha expirado.

$opterror=308

Script adspics: El anuncio no pertenece a la inmobiliaria indicada.

$opterror=401

Script adsresume: Llegó a ejecutarse el script pero hubo un error no definido, posiblemente falte algún parámetro el cual no puede ser reemplazado con su valor por defecto.

$opterror=402

Script adsresume: Inmobiliaria inexistente, no definida o icode incorrecto.
Verificar icode.

$opterror=403

Script adsresume: Inmobiliaria no tiene activado el servicio de nube. Ni de forma temporal, que lo activa el usuario desarrollador, ni de forma definitiva porque la inmobiliaria no posee un plan de pago. O puede ser el primer caso y el período de prueba ha expirado.