Inmuebles


Introducción

Esta es la lista de inmuebles de Apperty, es la ruta para obtener todos los inmuebles en los diferentes estados; su enfoque está destinado a páginas web y aplicaciones para mostrar inmuebles con su respectivo paginador y toda la información necesaria

Ejemplo de uso

{success} Url: /api/properties

use GuzzleHttp\Client;

$client = new Client();
$res = $client->request("GET", "{$endpoint}/api/properties", [
    "headers" => [
        "Content-type" => "application/json",
        "Accept" => "application/json",
        "Authorization" => "TOKEN_INGRESO"
    ]
]);

$properties = json_decode($res->getBody(), true);
return $properties;

Ejemplo de respuesta

{
    "total": 1,
    "per_page": 12,
    "current_page": 1,
    "last_page": 1,
    "from": 1,
    "to": 1,
    "data": [
        {
            "unique_code": 1,
            "code": 1234,
            "code_text": "123456-abc",
            "biz_service": "ARRIENDO",
            "type_code": 1,
            "type": "Property Type",
            "title": "Property title",
            "description": "Property description.",
            "ubication_text": "Property location",
            "neighborhood": "Barrio",
            "latitude": "1.4910616935449887",
            "longitude": "-26.48856237014577",
            "geohash": "",
            "address": "Property address",
            "primary_area": 200,
            "bedrooms": 2,
            "bathrooms": 3,
            "parking": 1,
            "build_year": 2011,
            "stratum": 5,
            "consignment_date": "2020-01-20 00:00:00",
            "video": "https://www.youtube.com/watch?v=ExampleYoutubeCode",
            "virtual_tour": "",
            "featured": true,
            "exclusive": false,
            "separate": 1,
            "count_images": 16,
            "count_images_360": 0,
            "featured_image": "https://pictures.domus.la/featuredImage.jpg",
            "status_code": 1,
            "status_name": "Disponible",
            "tags": [
                {
                    "code": 1,
                    "name": "Tag 1",
                    "color": "'#0000",
                    "text_color": "'#fff",
                    "is_public": false
                },
                {
                    "code": 2,
                    "name": "Tag 2",
                    "color": "'#f0f0f0",
                    "text_color": "'#000",
                    "is_public": true
                }
            ],
            "prices": [
                {
                    "biz_service_id": 1,
                    "name": "Arriendo",
                    "price": 21000000,
                    "currency": "peso",
                    "currency_prefix": "$"
                },
                {
                    "biz_service_id": 3,
                    "name": "Administración",
                    "price": 600000,
                    "currency": "peso",
                    "currency_prefix": "$"
                }
            ],
            "portals": [
                {
                    "code": "12345",
                    "status": "SUCCESS",
                    "url": "url-inmueble.com",
                    "portal_code": 1,
                    "portal_name": "Portal",
                    "portal_logo": "logo-portal.png"
                },
            ],
            "branch": {
                "code": 1,
                "name": "Example Branch",
                "address": "Example address",
                "ubication_text": "Example location",
                "latitude": "1.4510678",
                "longitude": "-29.5557707",
                "phone": "123456789",
                "mobile_phone": "123456789",
                "whatsapp_number": "123456789"
            },
            "company": {
                "code": 1,
                "name": "Example company",
                "email": "[email protected]",
                "logo": "http://example/example_logo.png",
                "phone": "123456789",
                "mobile_phone": "123456789",
                "whatsapp_number": "123456789"
            },
            "promoter": {
                "code": 1,
                "name": "Monroe Konopelski",
                "email": "[email protected]",
                "picture": "https://via.placeholder.com/800x800.png/00bbaa?text=rerum",
                "phone": "123456789",
                "mobile_phone": "123456789",
                "whatsapp_number": "123456789"
            },
            "catcher": {
                "code": 1,
                "name": "Monroe Konopelski",
                "email": "[email protected]",
                "picture": "https://via.placeholder.com/800x800.png/00bbaa?text=rerum",
                "phone": "123456789",
                "mobile_phone": "123456789",
                "whatsapp_number": "123456789"
            }
        }
    ]
}

Parámetros que recibe

Por Header

Parámetro Descripción Ejemplo
Authorization Token de ingreso e identificador de la inmobiliaria (obligatorio) "Authorization" => "TOKEN_INGRESO"
Perpage Cantidad de inmuebles a mostrar por página (por defecto 1) "Perpage" => 12

Por URL

En general la mayoría de parámetros que no se trate de rangos o campos de texto se pueden buscar con valores múltiples, por ejemplo tipo de inmueble, gestión, entre otros: "&type=1,2"

Parámetro Descripción Ejemplo
page Numero de la pagina que desea ver &page=3
title El título o parte del título de la propiedad ?title=Prueba...
type Tipo de inmueble de la propiedad &type=1,2
code_text Código de la propiedad, busca por campo "code", "code_text" y códigos del inmueble en portales &code_text=1
multiple_code_text Filtros por varios code_text &multiple_code_text=1,2,3
multiple_code Filtros por varios code &multiple_code=1,2,3
multiple_unique_code Filtros por varios unique_code &multiple_unique_code=1,2,3
location Ubicación o parte de la ubicación de la propiedad &location=Bogota...
exact_location Ubicación exacta de la propiedad &exact_location=Bogota
location_id Código de la ubicación de la propiedad &location_id=1,2
neighborhood Busca por el nombre del barrio &neighborhood=Chicó
country Busca por el país del inmueble &country=1
branch Sucursal de la propiedad &branch=1,2
address Dirección o parte de la dirección de la propiedad &address=Calle...
agent Agente promotor específico de la propiedad &agent=1
featured Validacion de si la propiedad es destacada &featured=1
exclusive Validacion de si la propiedad es exclusiva &exclusive=1
biz Gestión de la propiedad &biz=1
status Estado o estados de disponibilidad de la propiedad &status=1,2
general Búsqueda por palabra clave, es una búsqueda general &general=Prueba
minarea Rango mínimo de área &minarea=1
maxarea Rango máximo de área &maxarea=400
minbedrooms Rango mínimo de habitaciones &minbedrooms=1
maxbedrooms Rango máximo de habitaciones &maxbedrooms=2
minbathrooms Rango mínimo de baños &minbathrooms=1
maxbathrooms Rango máximo de baños &maxbathrooms=2
minparking Rango mínimo de parqueaderos &minparking=1
maxparking Rango máximo de parqueaderos &maxparking=2
minstratum Rango mínimo de estrato &minstratum=1
maxstratum Rango máximo de estrato &maxstratum=6
minbuild_year Rango mínimo de año de construcción &minbuild_year=2020
maxbuild_year Rango máximo de año de construcción &maxbuild_year=2063
created_date Rango de fechas de creación, entre una fecha y la otra se debe poner una eñe (ñ) para dejar clara la diferencia &created_date=2020-03-25 10:00:00ñ2020-03-26 10:00:00
minprice Rango mínimo de precio &minprice=2020
maxprice Rango máximo de precio &maxprice=2063
tags Etiquetas de los inmuebles &tags=1,2,3
amenities Características de los inmuebles &amenities=1,2,3

Índices de ordenamiento

Son parámetros también enviados por url que permiten organizar los inmuebles de acuerdo a diferentes parámetros, en general se debe enviar como "&order=order&sort=SORT" para que funcione en coherencia, sin embargo esto no es necesario con los últimos dos índices (pricemin y pricemax)

Parámetro Descripción Ejemplo
ASC Orden ascendente &sort=asc
DESC Orden descendente &sort=desc
id Orden por tiempo de creación &order=id
primary_area Orden por área &order=primary_area
pricemin Ordenar por precio de menor a mayor &order=pricemin
pricemax Ordenar por precio de mayor a menor &order=pricemax