Este es el método para crear inmuebles, se hacen varias validaciones y desde aquí
es posible agregar nuevos inmuebles en la inmobiliaria. Este método debe manejarse
con mucho cuidado porque los inmuebles que se insertan no se pueden borrar de la base
de datos, sin embargo, se puede cambiar su estado.
No se puede agregar inmuebles a otras inmobiliarias diferentes a la propia, pero se pueden
agregar inmuebles a otras sucursales de la misma inmobiliaria desde este método.
En el ejemplo se puede observar que los elementos se envían como "json", debido
a que no se pueden enviar simplemente en la url porque causaría una reacción adversa por parte
del API.
Las imágenes se suben en un método aparte y ese es un método que aplica tanto para creación
como para actualización de inmuebles.
{success} POST: /properties
use GuzzleHttp\Client;
$client = new Client();
$res = $client->request("POST", "{$endpoint}/properties", [
"headers" => [
"Content-type" => "application/json",
"Accept" => "application/json",
"Authorization" => "TOKEN_INGRESO"
],
"json" => [
"code" => 12345,
"description" => "Descripción de prueba para creación",
"amenities" => [
[
"id": 11,
"nombre": "habitaciones",
"valor": "2",
"comentario": "Dos habitaciones dobles",
"segundaria": [
"id": 54,
"name": "Doble",
"amenity_id": 11
]
]
]
]
]);
$properties = json_decode($res->getBody(), true);
return $properties;
{
"code": 200,
"message": "The property was created successfully",
"property": {
"unique_code": 123456,
"code": 123
}
}
Parámetro | Descripción | Ejemplo |
---|---|---|
Authorization | Token de ingreso e identificador de la inmobiliaria (obligatorio) | "Authorization" => "TOKEN_INGRESO" |
Los parámetros en negrilla son obligatorios. Los parámetros en cursiva pueden ser obligatorios de acuerdo a la configuración inicial de la inmobiliaria
Parámetro | Descripción | Ejemplo |
---|---|---|
title | Título del inmueble | &title=Inmueble en... |
property_type | Tipo de inmueble | &property_type=1 |
ubication1 | País del inmueble | &ubication1=1 |
address | Dirección del inmueble | &address=Calle 22... |
latitude | Latitud de la dirección | &latitude=4.12... |
longitude | Longitud de la dirección | &latitude=-7.12... |
code | Código en texto o referencia del inmueble | &code=ABC123 |
rent | Si el inmueble está en arriendo (requerido si no se envía sale o single_rent) | &rent=true |
sale | Si el inmueble está en venta (requerido si no se envía rent o single_rent) | &sale=true |
single_rent | Si el inmueble está en alquiler por días (requerido si no se envía rent o sale) | &single_rent=true |
rent_price | Precio de arriendo del inmueble | &rent_price=100000 |
sale_price | Precio de venta del inmueble | &sale_price=100000 |
rent_per_date_price | Precio de alquiler por días del inmueble | &rent_per_date_price=100000 |
administration_price | Precio de administración del inmueble | &administration_price=100000 |
branch | Sucursal u oficina del inmueble (si no se envía, queda registrada la del usuario por defecto) | &branch=1 |
catcher_broker | Asesor captador del inmueble (si no se envía, queda registrad el usuario por defecto) | &catcher_broker=1 |
promoter_broker | Asesor captador del inmueble (si no se envía, queda registrad el usuario por defecto) | &promoter_broker=1 |
consignation_date | Fecha de consignación | &consignation_date=2020-03-03 10:00:00 |
stratum | Estrato del inmueble | &stratum=2 |
featured | ¿Es inmueble destacado? | &featured=true |
exclusive | ¿Tiene el inmueble mandato exclusivo? | &exclusive=true |
description | Descripción general del inmueble | &description=Descripción... |
ubication2 | Ubicación 2 del inmueble (generalmente sería departamento/región) | &ubication2=1 |
ubication3 | Ubicación 3 del inmueble (generalmente sería ciudad) | &ubication3=1 |
ubication4 | Ubicación 4 del inmueble (generalmente sería localidad/barrio) | &ubication4=1 |
neighborhood | Barrio en texto del inmueble | &neighborhood=1 |
video_platform | Plataforma de video donde está el video del inmueble (youtube por defecto) | &video_platform=1 |
video_code | Código del video en la plataforma seleccionada | &video_code=ah789adA |
virtual_tour | Url del tour virtual si tiene | &virtual_tour=https://... |
amenities | JSON con las características del inmueble (un ejemplo de ello está en el ejemplo de uso) | &amenities='{...}' |
custom_description_# | Descripción personalizada del inmueble, el número que se especifica corresponde al campo "code" de los elementos de la respuesta | &custom_description_2=Descripción del inmueble para portales |
custom_description_generated_# | Se especifica si ésta descripción fue generada con inteligencia artificial | custom_description_generated_#=1 |