Documentazione Experience Platform Panoramica di Experience Platform

Experience Platform Domande frequenti e guida alla risoluzione dei problemi

Ultimo aggiornamento: 4 aprile 2025

Creato per:

Sviluppatore

Questo documento contiene le risposte alle domande più frequenti su Adobe Experience Platform e una guida di alto livello per la risoluzione dei problemi relativi agli errori più comuni che possono verificarsi in qualsiasi API Experience Platform. Per le guide alla risoluzione dei problemi dei singoli servizi Experience Platform, vedere la directory per la risoluzione dei problemi dei servizi di seguito.

Domande frequenti

Di seguito è riportato un elenco di risposte alle domande più frequenti su Adobe Experience Platform.

Cosa sono le API Experience Platform?

Experience Platform offre più API RESTful che utilizzano richieste HTTP per accedere alle risorse Experience Platform. Queste API di servizio espongono ciascuna più endpoint e consentono di eseguire operazioni per elencare (GET), cercare (GET), modificare (PUT e/o PATCH) ed eliminare (DELETE) le risorse. Per ulteriori informazioni su endpoint e operazioni specifici disponibili per ciascun servizio, consulta la documentazione di riferimento API su Adobe I/O.

Come si formatta una richiesta API?

I formati di richiesta variano a seconda dell'API Experience Platform utilizzata. Il modo migliore per scoprire come strutturare le chiamate API è seguire gli esempi forniti nella documentazione del servizio Experience Platform specifico che si sta utilizzando.

Per ulteriori informazioni sulla formattazione delle richieste API, consulta la guida introduttiva all'API Experience Platform lettura di chiamate API di esempio.

Qual è la mia organizzazione?

Un’organizzazione è una rappresentazione Adobe di un cliente. Tutte le soluzioni Adobe con licenza sono integrate in questa organizzazione del cliente. Quando un'organizzazione ha diritto a Experience Platform, può assegnare l'accesso agli sviluppatori. L'ID organizzazione (x-gw-ims-org-id) rappresenta l'organizzazione per la quale deve essere eseguita una chiamata API ed è pertanto richiesto come intestazione in tutte le richieste API. Questo ID si trova tramite Adobe Developer Console: nella scheda Integrazioni, accedi alla sezione Panoramica per trovare una particolare integrazione per l'ID in Credenziali client. Per informazioni dettagliate su come eseguire l'autenticazione in Experience Platform, vedere esercitazione sull'autenticazione.

Dove posso trovare la mia chiave API?

È necessaria una chiave API come intestazione in tutte le richieste API. È disponibile tramite Adobe Developer Console. Nella console, nella scheda Integrazioni, passa alla sezione Panoramica per un'integrazione specifica e troverai la chiave in Credenziali client. Per informazioni dettagliate su come eseguire l'autenticazione in Experience Platform, vedere esercitazione sull'autenticazione.

Come si ottiene un token di accesso?

I token di accesso sono necessari nell’intestazione Autorizzazione di tutte le chiamate API. Possono essere generati utilizzando un comando CURL, a condizione che tu abbia accesso a un’integrazione per un’organizzazione. I token di accesso sono validi solo per 24 ore, dopo di che è necessario generare un nuovo token per continuare a utilizzare l’API. Per informazioni dettagliate sulla generazione dei token di accesso, consulta l'esercitazione sull'autenticazione.

Come si utilizzano i parametri di query?

Alcuni endpoint API Experience Platform 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 il simbolo del punto interrogativo (?) seguito da uno o più parametri di query nel formato paramName=paramValue. Quando si combinano più parametri in una singola chiamata, è necessario utilizzare una e commerciale (&) per separare i singoli parametri. L’esempio seguente illustra come viene rappresentata nella documentazione una richiesta che utilizza più parametri di query.

Esempi di parametri di query comunemente utilizzati includono:

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 relativa al servizio.

Come si indica un campo JSON da aggiornare in una richiesta PATCH?

Molte operazioni PATCH nelle API Experience Platform utilizzano stringhe JSON Pointer per indicare le proprietà JSON da aggiornare. Questi sono in genere inclusi nei payload di richiesta utilizzando il formato Patch JSON. Per informazioni dettagliate sulla sintassi richiesta per queste tecnologie, consulta la guida sui concetti fondamentali dell'API.

Posso usare Postman per effettuare chiamate alle API Experience Platform?

Postman è uno strumento utile per visualizzare le chiamate alle API RESTful. La guida introduttiva all'API di Experience Platform contiene un video e le istruzioni per l'importazione delle raccolte Postman. Inoltre, viene fornito un elenco di raccolte Postman per ciascun servizio.

Requisiti di sistema per Experience Platform

A seconda che si utilizzi l’interfaccia o l’API, si applicano i seguenti requisiti di sistema:

Per operazioni basate sull'interfaccia utente:

Un browser web moderno e standard. Sebbene sia consigliata l'ultima versione di Chrome, sono supportate anche le versioni principali corrente e precedenti di Firefox, Internet Explorer e Safari.
- Ogni volta che viene rilasciata una nuova versione principale, Experience Platform inizia a supportare la versione più recente, mentre il supporto per la terza versione più recente viene rimosso.
Tutti i browser devono avere cookie e JavaScript abilitati.

Per interazioni con API e sviluppatori:

Un ambiente di sviluppo da sviluppare per le integrazioni REST, streaming e Webhook.

Errori e risoluzione problemi

Di seguito è riportato un elenco di errori che possono verificarsi quando si utilizza un servizio Experience Platform. Per le guide alla risoluzione dei problemi dei singoli servizi Experience Platform, vedere la directory per la risoluzione dei problemi dei servizi di seguito.

Codici di stato API

I seguenti codici di stato possono essere rilevati in qualsiasi API Experience Platform. Ognuno di essi ha una varietà di cause, pertanto le spiegazioni fornite in questa sezione sono di natura generale. Per ulteriori dettagli sugli errori specifici nei singoli servizi Experience Platform, vedere la directory di risoluzione dei problemi dei servizi di seguito.

Codice di stato

Descrizione

Possibili cause

400

Richiesta non valida

La richiesta non è stata costruita correttamente, mancano informazioni sulla chiave e/o contiene una sintassi errata.

401

Autenticazione non riuscita

La richiesta non ha superato un controllo di autenticazione. Il token di accesso potrebbe essere mancante o non valido. Per ulteriori dettagli, consulta la sezione Errori token OAuth di seguito.

403

Non consentito

La risorsa è stata trovata, ma non si dispone delle credenziali corrette per visualizzarla.
È probabile che l'errore sia dovuto al fatto che non si dispone delle autorizzazioni di controllo di accesso necessarie per accedere o modificare la risorsa. Scopri come ottenere le autorizzazioni di controllo dell'accesso basate su attributi necessarie per utilizzare le API di Experience Platform.

404

Non trovato

Impossibile trovare la risorsa richiesta nel server. È possibile che la risorsa sia stata eliminata o che il percorso richiesto non sia stato immesso correttamente.

500

Errore interno del server

Si tratta di un errore lato server. Se effettui molte chiamate simultanee, potresti raggiungere il limite API e dover filtrare i risultati. Per ulteriori informazioni, consulta la guida per gli sviluppatori API Catalog Service nella sezione filtraggio dei dati. Attendi un attimo prima di riprovare a eseguire la richiesta e, se il problema persiste, contatta l’amministratore.

Errori di intestazione della richiesta

Tutte le chiamate API in Experience Platform richiedono intestazioni di richiesta specifiche. Per vedere quali intestazioni sono necessarie per i singoli servizi, consulta la documentazione di riferimento API. Per trovare i valori per le intestazioni di autenticazione richieste, vedere l'esercitazione sull'autenticazione. Se una di queste intestazioni risulta mancante o non valida durante una chiamata API, possono verificarsi gli errori seguenti.

Token OAuth mancante

{
    "error_code": "403010",
    "message": "Oauth token is missing."
}

Questo messaggio di errore viene visualizzato quando manca un'intestazione Authorization da una richiesta API. Prima di riprovare, assicurati che l’intestazione Autorizzazione sia inclusa con un token di accesso valido.

Token OAuth non valido

{
    "error_code": "401013",
    "message": "Oauth token is not valid"
}

Questo messaggio di errore viene visualizzato quando il token di accesso fornito nell'intestazione Authorization non è valido. Verificare che il token sia stato immesso correttamente oppure generare un nuovo token nella console Adobe I/O.

È richiesta una chiave API

{
    "error_code": "403000",
    "message": "Api Key is required"
}

Questo messaggio di errore viene visualizzato quando manca un'intestazione di chiave API (x-api-key) in una richiesta API. Prima di riprovare, assicurati che l’intestazione sia inclusa con una chiave API valida.

Chiave API non valida

{
    "error_code": "403003",
    "message": "Api Key is invalid"
}

Questo messaggio di errore viene visualizzato quando il valore dell'intestazione della chiave API (x-api-key) fornita non è valido. Prima di riprovare, assicurati di aver immesso correttamente la chiave. Se non conosci la tua chiave API, puoi trovarla nella console Adobe I/O: nella scheda Integrazioni, passa alla sezione Panoramica per una specifica integrazione per trovare la chiave API in Credenziali client.

Intestazione mancante

{
    "error_code": "400003",
    "message": "Missing header"
}

Questo messaggio di errore viene visualizzato quando manca un'intestazione organizzazione (x-gw-ims-org-id) in una richiesta API. Prima di riprovare, assicurati che l’intestazione sia inclusa nell’ID dell’organizzazione.

Profilo non valido

{
    "error_code": "403025",
    "message": "Profile is not valid"
}

Questo messaggio di errore viene visualizzato quando l'utente o l'integrazione Adobe I/O (identificata dal token di accesso nell'intestazione Authorization) non è autorizzata ad effettuare chiamate alle API Experience Platform per l'organizzazione fornita nell'intestazione x-gw-ims-org-id. Prima di riprovare, assicurati di aver fornito l’ID corretto per la tua organizzazione nell’intestazione. Se non conosci il tuo ID organizzazione, puoi trovarlo nella console Adobe I/O: nella scheda Integrazioni, passa alla sezione Panoramica per una specifica integrazione per trovare l'ID in Credenziali client.

Errore di aggiornamento tag

{
"errorMessage":"Supplied version=[\\\\\\\"a200a2a3-0000-0200-0000-123178f90000\\\\\\\"] does not match the current version on entity=[\\\\\\\"a200cdb2-0000-0200-0000-456179940000\\\\\\\"]"
}

Se è stata apportata una modifica a un’entità di origine o di destinazione come flusso, connessione, connettore di origine o connessione di destinazione da parte di un altro chiamante API, è possibile che venga visualizzato un errore e-mail. A causa della mancata corrispondenza delle versioni, la modifica che stai tentando di apportare non verrà applicata all’ultima versione dell’entità.

Per risolvere questo problema, è necessario recuperare nuovamente l'entità, assicurarsi che le modifiche siano compatibili con la nuova versione dell'entità, quindi inserire il nuovo etag nell'intestazione If-Match e infine eseguire la chiamata API.

Tipo di contenuto valido non specificato

{
    "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 POST, PUT o PATCH contiene un'intestazione Content-Type non valida o mancante. Verificare che l'intestazione sia inclusa nella richiesta e che il relativo valore sia application/json.

Area geografica utente mancante

{
    "error_code": "403027",
    "message": "User region is missing"
}

Questo messaggio di errore viene visualizzato in uno dei due casi seguenti:

Quando un'intestazione dell'ID organizzazione (x-gw-ims-org-id) errata o non valida viene passata in una richiesta API. Prima di riprovare, assicurati di includere l’ID corretto della tua organizzazione.
Quando l’account (rappresentato dalle credenziali di autenticazione fornite) non è associato a un profilo di prodotto per Experience Platform. Segui i passaggi su generazione delle credenziali di accesso nell'esercitazione sull'autenticazione API di Experience Platform per aggiungere Experience Platform al tuo account e aggiornare di conseguenza le credenziali di autenticazione.

Directory di risoluzione dei problemi del servizio

Di seguito è riportato un elenco di guide per la risoluzione dei problemi e documentazione di riferimento API per le API Experience Platform. Ogni guida alla risoluzione dei problemi fornisce le risposte alle domande frequenti e alle soluzioni ai problemi specifici dei singoli servizi Experience Platform. I documenti di riferimento API forniscono una guida completa a tutti gli endpoint disponibili per ciascun servizio e mostrano esempi di corpo della richiesta, risposte e codici di errore che potresti ricevere.

Servizio

Riferimento API

Risoluzione dei problemi

Controllo degli accessi

API di controllo degli accessi

Guida alla risoluzione dei problemi relativi al controllo degli accessi

Acquisizione dei dati Adobe Experience Platform

Batch Ingestion API

Guida alla risoluzione dei problemi di acquisizione in batch

Acquisizione dei dati Adobe Experience Platform

Streaming Ingestion API

Guida alla risoluzione dei problemi di acquisizione in streaming