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
- offre una moderna integrazione CDN che consente l’annullamento della validità del contenuto attivo
- 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:
-
è il successore di Supporto per frammenti di contenuto nell'API HTTP di AEM Assets
-
integra le API OpenAPIs per frammenti di contenuto e modelli per frammenti di contenuto, che consentono di gestire i frammenti di contenuto e i modelli per frammenti di contenuto (CRUD)
-
è un'alternativa HTTP REST all'API GraphQL di AEM da utilizzare con i frammenti di contenuto
Per la documentazione completa consulta Distribuzione di frammenti di contenuto di AEM con OpenAPI.
- 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
La distribuzione dei frammenti di contenuto con OpenAPI supporta l’annullamento della validità della cache CDN attiva. Ciò significa che ogni volta che il contenuto viene aggiornato o pubblicato, le corrispondenti risposte JSON OpenAPI vengono automaticamente invalidate tramite una richiesta di eliminazione temporanea a Fastly. Questo consente di visualizzare le modifiche riportate nell'output JSON prima che venga raggiunta l'età effettiva della cache CDN (s-maxage).
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.