LA RISPOSTA DI PAGINA

Sito, layout e integrazioni

Oltre al contenuto della singola pagina, la risposta trasporta il contesto del sito: identita visiva, modello di pagina applicato, profili social, servizi di terze parti, risorse da iniettare nel documento e indirizzi delle informative. Sono i dati che il software di rendering applica a ogni pagina allo stesso modo.

L'oggetto website

Raccoglie i dati del sito che non dipendono dalla pagina richiesta. Il suo contenuto e identico in tutte le risposte finche non cambia la configurazione nel pannello.

Proprieta	Descrizione
`name`	Nome del sito. Usato nei metadati di condivisione e come testo alternativo di riserva per il logo.
`release`	Versione corrente della configurazione del sito. Cambia a ogni pubblicazione delle impostazioni ed e utile come suffisso per invalidare la cache degli asset del client.
`icons`	Icone dell'applicazione, gia risolte a indirizzi assoluti.
`logos`	Loghi del sito, uno per posizione e per tema.
`externalRatings`	Valutazioni raccolte su piattaforme esterne, con source, score, count e url.
`assetsBasePath`	Percorso base della cartella di asset propri del sito, relativo alla radice del progetto di rendering.

Icone e loghi

L'oggetto icons espone sei indirizzi: favicon, favicon16x16, favicon32x32, appleTouchIcon, androidChrome192Icon e androidChrome512Icon. Ogni indirizzo non caricato nel pannello risulta assente.

L'oggetto logos espone otto posizioni: per la testata desktop, la testata mobile, il menu mobile e il pie di pagina, ciascuna nella variante chiara e nella variante per tema scuro. I nomi delle varianti scure contengono Dark.

Ogni logo e un contenuto multimediale completo, con type, url, thumbnailUrl, alt, width e height. Le dimensioni vanno riportate negli attributi dell'immagine per evitare lo spostamento del layout durante il caricamento.

Quando una variante scura non e configurata, la proprieta corrispondente e assente. Il client ricade sulla variante chiara della stessa posizione.

Il layout

L'oggetto layout indica il modello di pagina applicato dal pannello: id, name e l'eventuale popup.

Il nome del layout e il criterio con cui il software di rendering sceglie il proprio modello di presentazione. Il layout stabilisce inoltre quali regioni e quante aree di contenuto la pagina puo avere.

Quando popup e presente, la proprieta displayMode indica quando aprire il popup del layout: None nessuna apertura, OnStart all'avvio, OnStartOncePerDay all'avvio una sola volta al giorno, OnExitOncePerDay all'uscita una sola volta al giorno. Il contenuto del popup arriva tra i componenti condivisi della pagina.

L'elenco socials contiene i profili configurati per il sito. Ogni voce ha type, url e sortOrder. Il tipo assume uno dei valori Facebook, Instagram, Twitter, TikTok, LinkedIn, WhatsApp, YouTube, Pinterest, Flickr, Twitch, Tumblr o Vimeo. L'icona corrispondente spetta al client; l'ordinamento va rispettato.

L'oggetto contractPages espone privacyPolicyUrl e cookiePolicyUrl, gli indirizzi assoluti delle informative pubblicate nella lingua della pagina. Sono i collegamenti da usare nel pie di pagina e nei moduli che richiedono un consenso, senza costruirli a mano.

Servizi di terze parti

L'elenco plugins trasporta i servizi esterni configurati nel pannello e le chiavi necessarie ad attivarli. Il codice di attivazione non viene generato dall'API: e il software di rendering a inserirlo.

Proprieta	Descrizione
`type`	Servizio: GoogleAnalytics, GoogleTagManager, FacebookPixel, GoogleMaps, Iubenda, Cookiebot, Smartsupp.
`key`	Chiave principale del servizio: identificativo di misurazione, di contenitore o chiave API.
`key2`	Seconda chiave, per i servizi che ne richiedono due.
`isCmp`	Indica che il servizio e la piattaforma di gestione dei consensi del sito. Va caricato prima degli altri, perche ne governa l'attivazione.

Le chiavi arrivano al client e restano visibili nel documento pubblicato: sono identificativi di servizio, non segreti. Il segreto usato per firmare le chiamate all'API non compare mai nella risposta e non va esposto lato client.

Risorse da inserire nel documento

L'elenco clientInjections contiene le risorse lato client dichiarate dallo sviluppatore nel pannello. Ogni voce descrive che cosa inserire, dove inserirlo e a quale consenso e subordinato.

Proprieta	Valori e descrizione
`code`	Codice identificativo della risorsa, stabile tra le pubblicazioni.
`type`	MetaTag, ExternalScript, InlineScript, Stylesheet, RawHtml.
`placement`	Head, BodyStart, BodyEnd: la posizione nel documento.
`attributesJson`	Attributi da applicare al tag, in forma di oggetto JSON serializzato come stringa. Il valore predefinito e un oggetto vuoto.
`content`	Corpo della risorsa, per gli script inline e l'HTML. Assente per gli script esterni, dove l'indirizzo e negli attributi.
`consentCategory`	Categoria di consenso richiesta. Se valorizzata, la risorsa va inserita solo dopo il consenso corrispondente.
`sortIndex`	Ordine di inserimento all'interno della stessa posizione.

attributesJson e content sono scritti dallo sviluppatore nel pannello e vengono restituiti senza trasformazioni. Il software di rendering li tratta come codice proprio, non come contenuto redazionale, e ne verifica la provenienza prima di inserirli nel documento.

L'ordine di inserimento e dato da placement e, a parita di posizione, da sortIndex crescente.

Contesto del sito

{
  "layout": {
    "id": "d9ff2cc6-1550-4bc1-90cb-4d1eb8766982",
    "name": "Pagina"
  },
  "website": {
    "name": "GajaCms",
    "release": "2026.9.2",
    "icons": {
      "favicon": "https://static.gajacms.com/gajacms/images/appicons/favicon.ico",
      "favicon16x16": "https://static.gajacms.com/gajacms/images/appicons/favicon-16x16.png",
      "favicon32x32": "https://static.gajacms.com/gajacms/images/appicons/favicon-32x32.png",
      "appleTouchIcon": "https://static.gajacms.com/gajacms/images/appicons/apple-touch-icon.png",
      "androidChrome192Icon": "https://static.gajacms.com/gajacms/images/appicons/android-chrome-192x192.png",
      "androidChrome512Icon": "https://static.gajacms.com/gajacms/images/appicons/android-chrome-512x512.png"
    },
    "logos": {
      "desktopNavLogo": {
        "type": "Image",
        "url": "https://static.gajacms.com/gajacms/images/applogos/0ec8b803.webp",
        "thumbnailUrl": "https://static.gajacms.com/gajacms/images/thumbs/th-0ec8b803.jpg",
        "alt": "GajaCms Logo",
        "width": 300,
        "height": 94
      }
    },
    "externalRatings": [],
    "assetsBasePath": "assets/gajacms"
  },
  "socials": [],
  "plugins": [],
  "clientInjections": [],
  "contractPages": {
    "privacyPolicyUrl": "https://www.gajacms.com/privacy-policy",
    "cookiePolicyUrl": "https://www.gajacms.com/cookies-policy"
  }
}