Cerca API di Assets search-assets-api
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.
La ricerca delle risorse approvate corrette dall’archivio Experience Manager è il primo passo per consegnare le risorse utilizzando l’URL di consegna. La risposta alla richiesta di ricerca comprende un array di documenti JSON corrispondenti alle risorse che soddisfano i criteri di ricerca. Ogni documento JSON viene identificato utilizzando un campo id, utilizzato per comporre la richiesta di consegna della risorsa.
Puoi definire le proprietà all’interno della richiesta API Search Assets per abilitare le seguenti funzionalità:
-
Ricerca full-text: utilizza la query
matchper definire il testo da cercare. È inoltre possibile utilizzare gli operatori all'interno della querymatchper filtrare i risultati. -
Applica filtri: utilizzare la query
termper filtrare ulteriormente i risultati definendo unkeye uno o più valori.keyidentifica il campo il cui valore deve corrispondere evaluerappresenta l'elemento su cui confrontare il valore. Analogamente, è possibile utilizzare la queryrangeper definire un intervallo per un campo utilizzando le proprietà Greater-than (gt), Greater-than o equal-to (gte), Less-than (lt) e Less-than o equal-to (lte). -
Ordina risultati: utilizzare la proprietà
OrderByper ordinare i risultati di ricerca in base a uno o più campi. Puoi ordinare i risultati in ordine crescente o decrescente. -
Paginazione: utilizzare le proprietà
limitecursorper definire le proprietà di paginazione all'interno di una richiesta API di ricerca. La proprietàlimitdefinisce il numero massimo di elementi da recuperare in una risposta API. La proprietàcursorfacilita il recupero del punto iniziale per il successivo set di risorse definito nella proprietàlimit. Ad esempio, se definisci50come limite nella richiesta API, puoi utilizzare la proprietàcursorper avviare e recuperare i successivi 50 elementi utilizzando la richiesta API successiva.
Endpoint API per la ricerca di risorse search-assets-api-endpoint
L’endpoint in una richiesta API di Search assets deve essere nel seguente formato:https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/search
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
Metodo di richiesta API per la ricerca di risorse search-assets-api-request-method
POST
Cerca nell’intestazione API di Assets search-assets-api-header
Durante la definizione di un’intestazione nell’API Search Assets devi fornire i seguenti dettagli:
headers: {
'Content-Type': 'application/json',
'X-Adobe-Accept-Experimental': '1',
Authorization: 'Bearer <YOUR_JWT_HERE>',
'X-Api-Key': 'YOUR_API_KEY_HERE'
},
Per richiamare l'API di ricerca, è necessario un token IMS per definire nei dettagli Authorization. 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 Search Assets.
Per visualizzare esempi di richieste, campioni di risposta e codici di risposta, vedere Cerca nell'API Assets.