Distribuzione di frammenti di contenuto di AEM con OpenAPI aem-content-fragment-delivery-with-openapi

In Adobe Experience Manager (AEM) as a Cloud Service, AEM OpenAPI per la distribuzione dei frammenti di contenuto:

  • è un’API OpenAPI ottimizzata per la distribuzione live di frammenti di contenuto AEM in formato JSON
  • si concentra sulla distribuzione dei contenuti (prestazioni, scalabilità, integrazione CDN, controllo e output JSON ottimizzati)
  • include la possibilità di idratare JSON per i frammenti e le risorse di riferimento

Questa API:

Per la documentazione completa consulta Distribuzione di frammenti di contenuto di AEM con OpenAPI.

NOTE
Consulta API di AEM per la distribuzione e la gestione strutturata dei contenuti per una panoramica delle varie API disponibili e un confronto di alcuni dei concetti coinvolti.
IMPORTANT
Per abilitare Content Fragment Delivery con OpenAPI su AEM as a Cloud Service, accertati che non sia già abilitato, quindi invia un ticket di supporto Adobe con il titolo Enable Content Fragment Delivery with OpenAPI e specifica:
  • ID del programma Cloud Service e dell'ambiente
  • dettagli del caso d’uso che desideri risolvere con Content Fragment Delivery OpenAPI
  • i dettagli di tutti i contatti a cui Adobe deve rispondere e rimanere informato sulla richiesta e sul progetto (se necessario)

Memorizzazione in cache caching

AEM si integra con AEM CDN Fastly. Ciò significa che le risposte JSON distribuite sul livello di pubblicazione sono memorizzate nella cache al livello Fastly.

Le risposte vengono quindi memorizzate nella cache, in base alle intestazioni di memorizzazione in cache predefinite (non può essere configurato):

  • Le risposte vengono memorizzate nella cache del browser/client per 5 minuti
    • max-age=300
  • Le risposte vengono memorizzate nella cache della rete CDN per 1 ora
    • s-maxage=3600
  • È possibile distribuire contenuto non aggiornato durante la riconvalida di nuove richieste per un massimo di 1 ora
    • stale-while-revalidate=3600
  • I contenuti non aggiornati possono essere presentati, per errore, per un massimo di 1 giorno
    • stale-on-error=86400

Disponibilità availability

La Distribuzione dei frammenti di contenuto con OpenAPI è disponibile sui livelli di anteprima e pubblicazione. OpenAPI distribuisce frammenti di contenuto in formato JSON, sia per l’anteprima che per la distribuzione live.

Per visualizzare in anteprima la distribuzione dei frammenti di contenuto con OpenAPI puoi:

  • pubblica in anteprima
  • abilita l’accesso all’anteprima con elenco consentiti IP
  • ottenere l’URL di anteprima

CORS cors

Origini consentite CORS definiscono le origini che possono chiamare l’API.

Questa API non prende in considerazione le origini consentite CORS definite sul lato della configurazione del dispatcher, in particolare per GraphQL.

API Rate Limits api-rate-limits

L’API consente nuove richieste a una velocità massima di 200 richieste al secondo, per ambiente.

Una volta superato questo limite, l’API inizia a inviare 429 errori. Questi errori devono essere gestiti da qualsiasi applicazione client e le richieste non riuscite vengono ritentate dopo un nuovo tentativo di backoff esponenziale. La risposta HTTP viene fornita con un’intestazione specifica, Retry-After, che indica al client il tempo di attesa necessario prima di inviare di nuovo la richiesta.

Richieste autenticate authenticated-requests

Il supporto per le richieste autenticate può essere implementato con la chiave Edge CDN di AEM. L’utilizzo della chiave Edge della rete CDN di AEM consente di fare affidamento sulla rete CDN di AEM e garantire che solo specifiche richieste possano accedere all’API, in base all’intestazione della chiave Edge fornita.

NOTE
L’autorizzazione basata sugli ACL specifici dell’archivio non è attualmente supportata.

Consegna di un elemento composito deliver-a-composite-item

Puoi distribuire gli elementi compositi con le seguenti API:

  • Da API OpenAPI di gestione (API di gestione dei frammenti di contenuto)

  • API GraphQL AEM per l’utilizzo con Frammenti di contenuto

  • API di consegna REST. Esistono due percorsi:

    • precotto al momento della pubblicazione
    • consegna in-process da AEM
  • Per le risposte OpenAPI contenenti frammenti idratati di riferimento, le composizioni possono ridurre il sovraccarico di metadati di riferimenti e frammenti. La dimensione del payload dipende dalla struttura del contenuto e dalle opzioni di inclusione dei riferimenti. Il contenuto composito incorporato è incluso indipendentemente dalla profondità di riferimento, pertanto le risposte superficiali possono essere maggiori delle risposte equivalenti basate su riferimenti.

NOTE
Se il modello utilizzato all’interno di un campo composito non è pubblicato, l’API di consegna salta tale contenuto composito (con un registro di avviso sul server). È simile al comportamento esistente per i frammenti per i quali manca un modello pubblicato.
Assicurati che le pipeline di pubblicazione del cliente includano tutti i modelli a cui fanno riferimento le composizioni.
recommendation-more-help
experience-manager-cloud-service-help-main-toc