API di consegna delivery-apis

Tutte le risorse approvate disponibili nell'archivio Experience Manager Assets possono essere cercate e quindi consegnate alle applicazioni downstream integrate utilizzando un URL di consegna.

Eventuali modifiche apportate alle risorse approvate in DAM, inclusi gli aggiornamenti della versione e le modifiche ai metadati, vengono automaticamente riportate negli URL di consegna. Con un valore TTL (Time-to-Live) breve di 10 minuti configurato per la distribuzione delle risorse tramite CDN, gli aggiornamenti diventano visibili in meno di 10 minuti su tutte le interfacce di authoring e pubblicazione.

L’immagine seguente illustra gli URL di consegna disponibili:

API di consegna

La tabella seguente illustra l’utilizzo delle varie API di consegna disponibili:

API di consegna
Descrizione
Rappresentazione binaria ottimizzata per il web della risorsa nel formato di output richiesto
Restituisce la rappresentazione binaria ottimizzata per il web della risorsa nel formato di output richiesto in base all’ID risorsa inviato nella richiesta. Inoltre, puoi definire vari modificatori di immagini, ad esempio larghezza, altezza, rotazione, capovolgimento, qualità, ritaglio, formato e ritaglio avanzato. Consulta Dettagli API per i formati e i modificatori di immagini supportati.
L'Adobe consiglia di utilizzare questa API per tutti i tipi di formato immagine.
Rappresentazione binaria ottimizzata per il web della risorsa
L’API di convenienza che applica i valori predefiniti alla rappresentazione binaria ottimizzata per il web della risorsa restituita nella risposta. I valori predefiniti includono un formato standard JPEG/WEBP, qualità => 65 e larghezza => 1024.
File binario caricato originale della risorsa
Restituisce i file binari caricati originariamente per la risorsa. L’Adobe consiglia di utilizzare questa API per i tipi di formato di documento e le immagini SVG.
Rendering pregenerato della risorsa disponibile nell'ambiente di authoring AEM Assets
Restituisce il bitstream del rendering della risorsa disponibile nell’ambiente di authoring AEM Assets in base all’ID risorsa e al nome del rendering inviati nella richiesta.
Metadati risorsa
Restituisce le proprietà associate a una risorsa, ad esempio titolo, descrizione, CreateDate, ModifyDate e così via.
Contenitore lettore per la risorsa video
Restituisce il contenitore del lettore per la risorsa video. Puoi incorporare il lettore in un elemento iframe HTML e riprodurre il video.
Manifesti di riproduzione nel formato di output selezionato
Restituisce il file del manifesto di riproduzione per la risorsa video specificata nel formato di output selezionato. Per poter estrarre il file del manifesto di riproduzione e riprodurre il video, è necessario creare un lettore personalizzato in grado di eseguire lo streaming adattivo tramite i protocolli HLS o DASH.

Endpoint API di consegna delivery-apis-endpoint

Gli endpoint API variano per ogni API di consegna. Ad esempio, l'endpoint API per l'API Web-optimized binary representation of the asset in the requested output format è:
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/{assetId}/as/{seoName}.{format}

Il dominio di consegna è simile nella struttura al dominio dell’ambiente di authoring Experience Manager. L'unica differenza consiste nella sostituzione del termine author con delivery.

pXXXX fa riferimento all'ID del programma

eYYYY fa riferimento all'ID ambiente

Per ulteriori informazioni, vedere Dettagli API.

Metodo di richiesta API di consegna delivery-api-request-method

GET

Intestazione API di consegna deliver-assets-api-header

Durante la definizione di un’intestazione nell’intestazione delle API di consegna, devi fornire i seguenti dettagli:

headers: {
      'If-None-Match': 'string',
      Authorization: 'Bearer <YOUR_JWT_HERE>'
    }

Per richiamare le API di consegna, è necessario un token IMS nei dettagli Authorization per inviare una risorsa con restrizioni. Il token IMS viene recuperato da un account tecnico. Consulta Recuperare le credenziali di AEM as a Cloud Service per creare un nuovo account tecnico. Consulta Generazione del token di accesso per generare il token IMS e utilizzarlo in modo appropriato nell'intestazione della richiesta API di consegna.

Per visualizzare esempi di richieste, campioni di risposta e codici di risposta, vedi API di consegna.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab