Este serviço retorna o design que o cliente configurou na sua conta —cores, tipografia, logo, favicon, slides, chamadas para ação, responsável do rodapé e redes sociais— em um formato pronto para consumir.

A diferença em relação a settings-v2 é o formato: lá o design chega misturado com o resto da configuração, como uma lista plana de pares nome/valor com a nomenclatura interna da Mapaprop; aqui chega agrupado por seção e, principalmente, as imagens vêm já resolvidas, não como fragmentos que você precisa montar. Para o design, este é o serviço recomendado.

URL do recurso

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

Código de exemplo

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}

Resposta

Um documento JSON com seis seções. As seis vêm sempre, mas dentro de cada uma só viajam os campos que o cliente configurou: os vazios são omitidos. Um cliente que só preencheu Instagram e Facebook recebe um social com essas duas chaves e nada mais.

Por isso convém ler cada campo com um valor padrão do seu lado (design.social.youtube ?? "") em vez de supor que a chave está lá.

As imagens

logo, favicon e slides[].image vêm resolvidos: se o cliente carregou a imagem a partir da sua conta, chegam como URL absoluta pronta para usar. Use-a como está, sem acrescentar nenhum domínio nem reconstruir o caminho.

Quando o cliente substitui uma imagem, essa URL pode vir com um parâmetro ?v= no final. Isso é intencional: força o navegador a baixar a imagem nova em vez de continuar mostrando a anterior. Mantenha a URL completa, com esse parâmetro incluído.

Os três blocos e os três slides vêm sempre

callToActions traz sempre três elementos e slides sempre três, estejam configurados ou não. Os blocos trazem enabled para que você saiba quais mostrar; os slides sem imagem chegam com image vazio. Assim você pode percorrer as listas por posição sem se preocupar com o comprimento delas.

Com que frequência pedi-lo

O design muda pouco: é configurado uma vez e ajustado de vez em quando. A resposta fica em cache por uma hora, então não faz sentido pedi-la a cada visita — peça-a ao construir a página ou guarde-a do lado do seu servidor.

Resposta de exemplo

{
  "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": "Encontre seu próximo lar",
        "subtitle": "Mais de 400 imóveis"
      },
      {
        "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"
  }
}