Este servicio devuelve el diseño que el cliente configuró en su cuenta —colores, tipografía, logo, favicon, slides, llamados a la acción, responsable del pie de página y redes sociales— en una forma lista para consumir.

La diferencia con settings-v2 es la forma: ahí el diseño llega mezclado con el resto de la configuración, como una lista plana de pares nombre/valor con la nomenclatura interna de Mapaprop; acá llega agrupado por sección y, sobre todo, las imágenes vienen ya resueltas, no como fragmentos que haya que componer. Para el diseño, este es el servicio recomendado.

URL del recurso

https://mapaprop.app/api/action/express-v1/design

Código de ejemplo

GET /api/action/express-v1/design 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 seis secciones. Las seis vienen siempre, pero dentro de cada una sólo viajan los campos que el cliente configuró: los vacíos se omiten. Un cliente que sólo cargó Instagram y Facebook recibe un social con esas dos claves y nada más.

Por eso conviene leer cada campo con un valor por defecto de tu lado (design.social.youtube ?? "") en vez de asumir que la clave está.

Las imágenes

logo, favicon y slides[].image vienen resueltos: si el cliente subió la imagen desde su cuenta, llegan como URL absoluta lista para usar. Usala tal cual, sin anteponerle ningún dominio ni reconstruir la ruta.

Cuando el cliente reemplaza una imagen, esa URL puede venir con un parámetro ?v= al final. Es intencional: obliga al navegador a bajar la imagen nueva en lugar de seguir mostrando la anterior. Conservá la URL completa, con ese parámetro incluido.

Los tres bloques y los tres slides vienen siempre

callToActions trae siempre tres elementos y slides siempre tres, estén configurados o no. Los bloques traen enabled para que sepas cuáles mostrar; los slides sin imagen llegan con image vacío. Así podés recorrer las listas por posición sin preocuparte por su longitud.

Cada cuánto conviene pedirlo

El diseño cambia poco: se configura una vez y se ajusta de vez en cuando. La respuesta se cachea una hora, así que no tiene sentido pedirla en cada visita — pedila al construir la página o guardala del lado de tu servidor.

Respuesta de ejemplo

{
  "colors": {
    "primary": "#195fa9",
    "primaryText": "#ffffff",
    "secondary": "#4a7fe8",
    "secondaryText": "#ffffff"
  },
  "typography": {
    "fontFamily": "Poppins"
  },
  "images": {
    "logo": "https://images.mapaprop.app/website-images/4069/963/logo.png?v=1786500000",
    "favicon": "https://images.mapaprop.app/website-images/4069/963/favicon.png?v=1786500000",
    "slides": [
      {
        "image": "https://images.mapaprop.app/website-images/4069/963/slide1.jpg",
        "url": "/propiedades",
        "title": "Encontrá tu próximo hogar",
        "subtitle": "Más de 400 propiedades"
      },
      {
        "image": "https://images.mapaprop.app/website-images/4069/963/slide2.jpg",
        "url": "/contacto"
      },
      {}
    ]
  },
  "callToActions": [
    {
      "index": 1,
      "enabled": true,
      "title": "Tasación sin cargo",
      "description": "Conocé el valor de tu propiedad hoy.",
      "buttonText": "Solicitar tasación",
      "buttonLink": "/contacto"
    },
    {
      "index": 2,
      "enabled": false
    },
    {
      "index": 3,
      "enabled": false
    }
  ],
  "footer": {
    "responsible": "Responsable: Omar Gazze — Matrícula 59"
  },
  "social": {
    "instagram": "https://instagram.com/inmobiliaria",
    "facebook": "https://facebook.com/inmobiliaria"
  }
}