Questo documento fornisce le risposte alle domande più frequenti su Adobe Experience Platform, nonché una guida alla risoluzione dei problemi di alto livello per gli errori comuni che possono verificarsi in qualsiasi Experience Platform API. Per guide sulla risoluzione dei problemi individuali Platform servizi, vedi directory di risoluzione dei problemi del servizio sotto.
Di seguito è riportato un elenco di risposte alle domande frequenti su Adobe Experience Platform.
Experience Platform offre più API RESTful che utilizzano richieste HTTP per accedere Platform risorse. Ciascuna API di servizio espone più endpoint e consente di eseguire operazioni per elencare (GET), cercare (GET), modificare (PUT e/o PATCH) ed eliminare risorse (DELETE). Per ulteriori informazioni su endpoint e operazioni specifici disponibili per ogni servizio, consulta la sezione Documentazione di riferimento API Adobe I/O.
I formati di richiesta variano a seconda del Platform API utilizzata. Il modo migliore per strutturare le chiamate API è seguire gli esempi forniti nella documentazione per Platform servizio in uso.
Per ulteriori informazioni sulla formattazione delle richieste API, visita la guida introduttiva all’API Platform lettura di chiamate API di esempio sezione .
Un’organizzazione IMS è un Adobe di rappresentazione di un cliente. Tutte le soluzioni di Adobe con licenza sono integrate con questa organizzazione clienti. Quando un'organizzazione IMS ha diritto a Experience Platform, può assegnare l’accesso agli sviluppatori. ID organizzazione IMS (x-gw-ims-org-id
) rappresenta l’organizzazione per la quale deve essere eseguita una chiamata API ed è pertanto obbligatoria come intestazione in tutte le richieste API. Questo ID può essere trovato attraverso Console Adobe Developer: in Integrazioni , passa alla Panoramica sezione per qualsiasi integrazione particolare per trovare l’ID in Credenziali client. Per informazioni dettagliate su come eseguire l'autenticazione in Platform, vedi esercitazione sull'autenticazione.
Una chiave API è necessaria come intestazione in tutte le richieste API. Può essere trovato attraverso Console Adobe Developer. Nella console, nella Integrazioni , passa alla Panoramica per un’integrazione specifica e troverai la chiave in Credenziali client. Per informazioni dettagliate su come eseguire l'autenticazione in Platform, vedi esercitazione sull'autenticazione.
I token di accesso sono necessari nell’intestazione Autorizzazione di tutte le chiamate API. Possono essere generati utilizzando un curl
, purché sia possibile accedere a un’integrazione per un’organizzazione IMS. I token di accesso sono validi solo per 24 ore, dopodiché è necessario generare un nuovo token per continuare a utilizzare l’API. Per informazioni dettagliate sulla generazione dei token di accesso, consulta la sezione esercitazione sull'autenticazione.
Alcuni Platform Gli endpoint API accettano parametri di query per individuare informazioni specifiche e filtrare i risultati restituiti nella risposta. I parametri di query vengono aggiunti ai percorsi di richiesta con un punto interrogativo (?
), seguita da uno o più parametri di query che utilizzano il formato paramName=paramValue
. Quando combini più parametri in una singola chiamata, devi utilizzare una e commerciale (&
) per separare i singoli parametri. L’esempio seguente illustra come una richiesta che utilizza più parametri di query viene rappresentata nella documentazione.
Alcuni esempi di parametri di query comunemente utilizzati:
GET /tenant/schemas?orderby=title
GET /datasets?limit=36&start=10
GET /batches?createdAfter=1559775880000&orderBy=desc:created
Per informazioni dettagliate sui parametri di query disponibili per un servizio o un endpoint specifico, consulta la documentazione specifica del servizio.
Molte operazioni di PATCH in Platform Utilizzo delle API Puntatore JSON stringhe per indicare le proprietà JSON da aggiornare. In genere sono inclusi nei payload di richiesta utilizzando Patch JSON formato. Consulta la sezione Guida di base sulle API per informazioni dettagliate sulla sintassi richiesta per queste tecnologie.
Postman è uno strumento utile per visualizzare le chiamate alle API RESTful. La Guida introduttiva all’API di Platform contiene un video e istruzioni per l’importazione di raccolte Postman. Inoltre, viene fornito un elenco di raccolte Postman per ogni servizio.
A seconda dell’interfaccia utente o dell’API, si applicano i seguenti requisiti di sistema:
Per le operazioni basate sull’interfaccia utente:
Per le interazioni con API e sviluppatori:
Di seguito è riportato un elenco di errori che si possono verificare quando si utilizzano Experience Platform servizio. Per guide sulla risoluzione dei problemi individuali Platform servizi, vedi directory di risoluzione dei problemi del servizio sotto.
È possibile rilevare i seguenti codici di stato su qualsiasi Experience Platform API. Ognuno ha una varietà di cause, quindi le spiegazioni fornite in questa sezione sono di natura generale. Per maggiori dettagli sugli errori specifici in singoli Platform i servizi directory di risoluzione dei problemi del servizio sotto.
Codice di stato | Descrizione | Possibili cause |
---|---|---|
400 | Richiesta errata | La richiesta è stata costruita in modo errato, contiene informazioni chiave mancanti e/o contiene una sintassi non corretta. |
401 | Autenticazione non riuscita | La richiesta non ha superato un controllo di autenticazione. Token di accesso mancante o non valido. Consulta la sezione Errori del token OAuth per ulteriori informazioni, consulta la sezione seguente. |
403 | Proibito | La risorsa è stata trovata, ma non si dispone delle credenziali necessarie per visualizzarla. |
404 | Non trovato | Impossibile trovare la risorsa richiesta sul server. È possibile che la risorsa sia stata eliminata o che il percorso richiesto non sia stato inserito correttamente. |
500 | Errore interno del server | Errore lato server. Se effettui molte chiamate simultanee, potresti raggiungere il limite API e dover filtrare i risultati. (Vedi Catalog Service Guida secondaria per sviluppatori API su filtraggio dei dati per saperne di più). Attendi un attimo prima di riprovare la richiesta e, se il problema persiste, contatta l’amministratore. |
Tutte le chiamate API in Platform richiede intestazioni di richiesta specifiche. Per vedere quali intestazioni sono necessarie per i singoli servizi, consulta la sezione Documentazione di riferimento API. Per trovare i valori per le intestazioni di autenticazione richieste, vedi Esercitazione sull’autenticazione. Se una di queste intestazioni è mancante o non è valida durante una chiamata API, potrebbero verificarsi i seguenti errori.
{
"error_code": "403010",
"message": "Oauth token is missing."
}
Questo messaggio di errore viene visualizzato quando viene visualizzata una Authorization
intestazione mancante da una richiesta API. Assicurati che l’intestazione Autorizzazione sia inclusa con un token di accesso valido prima di riprovare.
{
"error_code": "401013",
"message": "Oauth token is not valid"
}
Questo messaggio di errore viene visualizzato quando il token di accesso fornito nel Authorization
intestazione non valida. Assicurati che il token sia stato immesso correttamente oppure genera un nuovo token nella console Adobe I/O.
{
"error_code": "403000",
"message": "Api Key is required"
}
Questo messaggio di errore viene visualizzato quando viene visualizzata un'intestazione di chiave API (x-api-key
) manca da una richiesta API. Assicurati che l’intestazione sia inclusa con una chiave API valida prima di riprovare.
{
"error_code": "403003",
"message": "Api Key is invalid"
}
Questo messaggio di errore viene visualizzato quando viene visualizzato il valore dell'intestazione della chiave API fornita (x-api-key
) non è valida. Assicurati di aver immesso correttamente la chiave prima di riprovare. Se non conosci la tua chiave API, puoi trovarlo nella Console Adobe I/O: in Integrazioni , passa alla Panoramica per un’integrazione specifica per trovare la chiave API in Credenziali client.
{
"error_code": "400003",
"message": "Missing header"
}
Questo messaggio di errore viene visualizzato quando un'intestazione org IMS (x-gw-ims-org-id
) manca da una richiesta API. Assicurati che l’intestazione sia inclusa con l’ID della tua organizzazione IMS prima di riprovare.
{
"error_code": "403025",
"message": "Profile is not valid"
}
Questo messaggio di errore viene visualizzato quando l'utente o l'integrazione di Adobe I/O (identificata da token di accesso in Authorization
header) non è autorizzato a effettuare chiamate a Experience Platform API per l’organizzazione IMS fornita nella x-gw-ims-org-id
intestazione. Assicurati di aver fornito l’ID corretto per la tua organizzazione IMS nell’intestazione prima di riprovare. Se non conosci il tuo ID organizzazione, puoi trovarlo nella Console Adobe I/O: in Integrazioni , passa alla Panoramica per un’integrazione specifica per trovare l’ID in Credenziali client.
{
"errorMessage":"Supplied version=[\\\\\\\"a200a2a3-0000-0200-0000-123178f90000\\\\\\\"] does not match the current version on entity=[\\\\\\\"a200cdb2-0000-0200-0000-456179940000\\\\\\\"]"
}
Puoi ricevere un errore di tag se un’altra chiamata API ha apportato una modifica a un’entità di origine o di destinazione come flusso, connessione, connettore di origine o connessione di destinazione. A causa di una mancata corrispondenza della versione, la modifica che stai tentando di apportare non verrà applicata all’ultima versione dell’entità.
Per risolvere questo problema, devi recuperare nuovamente l’entità, accertarti che le modifiche siano compatibili con la nuova versione dell’entità, quindi inserisci il nuovo tag nella If-Match
e infine effettua la chiamata API .
{
"type": "/placeholder/type/uri",
"status": 400,
"title": "BadRequestError",
"detail": "A valid content-type must be specified"
}
Questo messaggio di errore viene visualizzato quando una richiesta di POST, PUT o PATCH presenta una richiesta non valida o mancante Content-Type
intestazione. Verifica che l’intestazione sia inclusa nella richiesta e che il relativo valore sia application/json
.
{
"error_code": "403027",
"message": "User region is missing"
}
Questo messaggio di errore viene visualizzato in uno dei due casi seguenti:
x-gw-ims-org-id
) viene passato in una richiesta API. Assicurati di includere l’ID corretto della tua organizzazione IMS prima di riprovare.Di seguito è riportato un elenco delle guide per la risoluzione dei problemi e la documentazione di riferimento API per Experience Platform API. Ogni guida alla risoluzione dei problemi fornisce le risposte alle domande frequenti e le soluzioni ai problemi specifici delle singole persone Platform servizi. I documenti di riferimento API forniscono una guida completa a tutti gli endpoint disponibili per ogni servizio e mostrano corpi di richiesta di esempio, risposte e codici di errore che possono essere ricevuti.