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
{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;
{
"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á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 |
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 |
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 |