GET /api/action/express-v1/settings-v2

PROD

Este servicio provee la configuración general del sitio y del cliente a partir de un dominio.

Si lo que buscás es el diseño —colores, tipografía, logo, favicon, slides, llamados a la acción, redes—, usá GET /api/action/express-v1/design. Ahí llega agrupado por sección y con las imágenes ya resueltas como URL. Acá el diseño también viaja, pero mezclado con el resto de la configuración y en la nomenclatura interna de Mapaprop.

Información del recurso
Autenticación	Requerida (Token de API, Bearer)
Scope	`express-base`
HTTP Method	GET
Response	JSON
Version	1

URL del recurso

https://mapaprop.app/api/action/express-v1/settings-v2

Código de ejemplo

GET /api/action/express-v1/settings-v2 HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}

Respuesta

Un documento JSON con la configuración del cliente y del sitio web.

Objeto	Campo	Tipo	Requerido	Descripción
Response	settings	Array of Setting	yes	La lista de objetos Setting
	customer	Customer	yes	El objeto Customer
Setting	name	string	yes	El nombre del setting
	category	string	yes	La categoría a la que pertenece (ver la tabla de categorías más abajo)
	value	string	yes	El valor configurado. Puede venir vacío si el cliente no lo cargó
	custId	number	yes	El identificador de la cuenta
	websiteId	number	yes	El identificador del sitio
Customer	name	string	yes	El nombre de la empresa de la inmobiliaria
	address	string	yes	La dirección de la inmobiliaria
	zone0Description	string	yes	El país donde se ubica la inmobiliaria
	zone1Description	string	yes	La provincia/estado donde se ubica la inmobiliaria
	zone2Description	string	yes	El partido o barrio donde se ubica la inmobiliaria
	zone3Description	string	no	La ciudad donde se ubica la inmobiliaria
	zip	string	yes	El código postal de la inmobiliaria
	websiteActive	boolean	yes	Si el sitio web está activo o no. Si no lo está, ningún otro servicio retornará datos. Esto puede deberse a facturas impagas o a una cancelación simple
	phone1	string	yes	Un número de teléfono de la inmobiliaria
	phone2	string	no	Un número de teléfono alternativo de la inmobiliaria
	phone3	string	no	Un número de teléfono alternativo de la inmobiliaria
	mobile	string	no	Número de teléfono móvil para mensajería instantánea
	email	string	yes	El email del cliente
	bio	string	no	Texto libre de presentación de la inmobiliaria, el que carga en Mi Empresa > Biografía
	seoUrl	string	no	El identificador de la inmobiliaria en las URLs
	tempRental	boolean	no	Si la inmobiliaria opera alquileres temporarios. Con `false` no tiene sentido que ofrezcas ese filtro en tu buscador

Las categorías

Cada setting llega con la categoría a la que pertenece. Estas son las que vas a encontrar:

Categoría	Qué trae
`config`	Comportamiento general del sitio (por ejemplo, el modo de sucursales)
`resource`	Recursos del sitio: hoja de estilos, ruta de la plantilla, imágenes, código de Google Analytics, píxel de Meta
`desing`	Diseño: colores, tipografía, llamados a la acción y responsable del pie de página. El nombre de la categoría va sin la `g`: es histórico y llega así
`social`	Las redes sociales de la inmobiliaria
`branch`	Configuración vinculada a las sucursales
`mapbox`	Configuración del mapa
`reCaptchaV3`	La clave pública del sitio (`site.key`), la que necesitás para renderizar el widget
`features`	Funcionalidades habilitadas en el sitio
`chat.ai`	Configuración del chat con inteligencia artificial

El listado de settings no es fijo: crece a medida que se suman opciones de configuración, y cada cuenta trae solamente lo que configuró. Recorré la lista buscando el name que te interesa en lugar de asumir posiciones o una cantidad determinada de elementos.

La clave privada de reCAPTCHA no se devuelve y no hace falta: la validación del token la hacemos nosotros del lado del servidor cuando el visitante envía el formulario con POST /api/action/express-v1/messages.

Ejemplo de respuesta

{
  "settings": [
    {
      "name": "mode",
      "custId": 2230,
      "websiteId": 6001,
      "category": "config",
      "value": "some.branches"
    },
    {
      "name": "google.analytics",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "UA-16637317-1"
    },
    {
      "name": "logo",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/styles/customers/1687/logo.png"
    },
    {
      "name": "path",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "1687"
    },
    {
      "name": "slide1.image",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/styles/customers/1687/slide1.jpg"
    },
    {
      "name": "slide1.url",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/contacto"
    },
    {
      "name": "slide2.image",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/styles/customers/1687/slide2.jpg"
    },
    {
      "name": "slide2.url",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/contacto"
    },
    {
      "name": "slide3.image",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/styles/customers/1687/slide3.jpg"
    },
    {
      "name": "slide3.url",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/contacto"
    },
    {
      "name": "stylesheet",
      "custId": 2230,
      "websiteId": 6001,
      "category": "resource",
      "value": "/styles/customers/1687/style.css"
    }
  ],
  "customer": {
    "name": "Super Realtors Inc",
    "tempRental": true,
    "zone0Description": "Argentina",
    "zone1Description": "Capital Federal",
    "zone2Description": "Recoleta",
    "websiteActive": true,
    "phone1": "2334-3322",
    "phone2": "2334-3323",
    "mobile": "541122226666",
    "email": "info@fancy.com",
    "zip": "1425",
    "address": "Skype: apartments"
  }
}