LA RISPOSTA DI PAGINA

Contenuto risolto e sommario

La proprieta type dichiara che cosa e stato risolto e la proprieta content ne trasporta i dati. Insieme a publishedAt e al sommario gia calcolato, sono le informazioni che distinguono una pagina da un articolo, da una scheda prodotto o da una pagina della guida.

Il tipo di pagina

La proprieta type e la prima informazione da leggere dopo la route: dichiara la natura del contenuto risolto e permette al software di rendering di scegliere il proprio modello di presentazione.

Gruppo	Valori
Contenuti editoriali	`HomePage, Page, Post, Event, Product, Review, PageDoc`
Categorie	`PostCategory, EventCategory, ProductCategory`
Pagine di servizio	`PrivacyPolicy, CookiePolicy, TermsAndConditions, NewsletterUnsubscribe`
Ricerca e carrello	`Cart, ProductSearch, PostSearch`
Accesso	`Login, Register, LoginOrRegister, RegistrationConfirmation`
Area riservata	`ReservedHomePage, ReservedAccountPage, ReservedOrdersPage, ReservedCouponsPage, ReservedAddressesPage, ReservedDownloadsPage, ReservedChatPage, ReservedFavoritesPage, ReservedSettingsPage`

Le pagine di servizio, di ricerca, di accesso e dell'area riservata hanno una funzione fissa nel sito: il tipo indica al client quale schermata montare, mentre le regioni e le aree di contenuto continuano a fornire la parte redazionale.

L'oggetto content

L'oggetto content espone otto proprieta alternative fra loro. Al massimo una descrive l'entita risolta, coerente con type; la galleria di dettaglio puo accompagnarla.

Proprieta	Valorizzata quando type vale
`page`	`HomePage, Page, PageDoc e i tipi di servizio basati su una pagina`
`post`	`Post`
`event`	`Event`
`product`	`Product`
`postCategory`	`PostCategory`
`eventCategory`	`EventCategory`
`productCategory`	`ProductCategory`
`detailGallery`	qualunque tipo, quando il layout prevede una galleria di dettaglio

Il software di rendering non deve dedurre il tipo dalla presenza di una proprieta: legge type e accede alla proprieta corrispondente. Le altre sono assenti dal JSON.

La pagina generica

La proprieta content.page e volutamente essenziale, perche per una pagina generica tutti i dati redazionali si trovano gia nella route e nelle aree di contenuto.

Proprieta	Descrizione
`id`	Identificativo della pagina, uguale all'id di primo livello della risposta.
`absoluteUrl`	URL assoluto della pagina, quando valorizzato.
`title`	Titolo della pagina come entita, distinto dal titolo della route.
`description`	Descrizione della pagina come entita.

Gli altri contenuti risolti, come articolo, evento, prodotto e le relative categorie, hanno un contratto piu ampio, con categoria, autore, date, prezzi, valutazioni e contenuti correlati. Ciascuno e descritto nella pagina dedicata al proprio tipo.

La galleria di dettaglio

La proprieta content.detailGallery contiene la galleria che il layout associa alla pagina di dettaglio, tipicamente le immagini di una scheda prodotto o di un articolo. Espone un solo elenco, items, con la stessa forma degli elementi del componente galleria.

A differenza delle gallerie inserite nel contenuto, questa galleria non e mai a caricamento differito: se il layout la prevede, gli elementi arrivano nella risposta della pagina. Un elenco vuoto significa che la galleria e prevista ma priva di immagini.

Il sommario della pagina

L'elenco tableOfContents e gia calcolato dai titoli dei componenti della pagina e arriva nell'ordine di lettura. Ogni voce ha tre proprieta.

Proprieta	Descrizione
`id`	Ancora del titolo. Coincide con anchorId del titolo del componente e va usata come identificativo dell'elemento nel documento.
`label`	Testo della voce, gia privo di formattazione.
`level`	Profondita numerica del titolo, da usare per l'annidamento visivo del sommario.

Il collegamento di ciascuna voce si costruisce anteponendo il carattere # all'ancora. La corrispondenza con i titoli dei componenti e garantita: ogni voce del sommario ha un titolo corrispondente nel contenuto della pagina.

La proprieta publishedAt riporta la data e l'ora UTC di pubblicazione del contenuto. E il valore da usare per i dati strutturati e per le intestazioni di validita della cache del client.

Contenuto e sommario

{
  "type": "Page",
  "publishedAt": "2026-09-10T06:23:01.135761Z",
  "tableOfContents": [
    { "id": "a-nel-1997-nasce-la-smea", "label": "NEL 1997 NASCE LA SMEA", "level": 2 },
    { "id": "a-chi-siamo", "label": "CHI SIAMO", "level": 2 },
    { "id": "a-attivita-produttiva", "label": "ATTIVITA' PRODUTTIVA", "level": 2 }
  ],
  "content": {
    "page": { "id": "5eb29ec2-4634-4613-9fd3-9599f70f6918" },
    "detailGallery": { "items": [] }
  }
}