Platform Domande frequenti e guida alla risoluzione dei problemi

Questo documento fornisce le risposte alle domande frequenti su Adobe Experience Platform, nonché una guida alla risoluzione dei problemi di alto livello per gli errori comuni che possono verificarsi in qualsiasi API Experience Platform. Per le guide alla risoluzione dei problemi sui singoli servizi Platform, consulta la directory per la risoluzione dei problemi dei servizi di seguito.

Domande frequenti

Di seguito è riportato un elenco delle risposte alle domande frequenti su Adobe Experience Platform.

Cosa sono le API Experience Platform?

Experience Platform offre più API RESTful che utilizzano richieste HTTP per accedere alle Platform risorse. Queste API di servizio espongono entrambi più endpoint e consentono di eseguire operazioni per elencare (GET), cercare (GET), modificare (PUT e/o PATCH) e eliminare (DELETE) risorse. Per ulteriori informazioni su endpoint e operazioni specifici disponibili per ogni 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’ Platform API utilizzata. Il modo migliore per imparare a strutturare le chiamate API è seguire gli esempi forniti nella documentazione del particolare servizio Platform che utilizzi.

Per ulteriori informazioni sulla formattazione delle richieste API, visita la sezione Guida introduttiva all’API Platform lettura di chiamate API di esempio .

Qual è la mia organizzazione IMS?

Un’organizzazione IMS è una rappresentazione Adobe di un cliente. Tutte le soluzioni Adobe con licenza sono integrate con questa organizzazione clienti. Quando un’organizzazione IMS ha diritto a Experience Platform, può assegnare l’accesso agli sviluppatori. L’ID organizzazione IMS (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 , passa alla sezione Panoramica per qualsiasi integrazione particolare e trova l'ID in Credenziali client. Per informazioni dettagliate su come eseguire l'autenticazione in Platform, consulta l' esercitazione sull'autenticazione.

Dove posso trovare la mia chiave API?

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

Come posso ottenere 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, 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 l’ esercitazione sull’autenticazione.

Come si utilizzano i parametri di query?

Alcuni endpoint Platform 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 simbolo di punto interrogativo (?) seguito 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.

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

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

Posso utilizzare Postman per effettuare chiamate alle API Platform?

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

Quali sono i requisiti di sistema per Platform?

A seconda dell’interfaccia utente o dell’API, si applicano i seguenti requisiti di sistema:

Per le operazioni basate sull’interfaccia utente:

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

Per le interazioni con API e sviluppatori:

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

Errori e risoluzione dei problemi

Di seguito è riportato un elenco di errori che si possono verificare durante l'utilizzo di un servizio Experience Platform. Per le guide alla risoluzione dei problemi sui singoli servizi Platform, consulta la directory per la risoluzione dei problemi dei servizi di seguito.

Codici di stato API

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

| 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. Per ulteriori informazioni, consulta la sezione Errori token OAuth di seguito. |
| 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. (Per ulteriori informazioni, consulta la guida per gli sviluppatori Catalog Service API nella sezione filtro dei dati .) Attendi un attimo prima di riprovare la richiesta e, se il problema persiste, contatta l’amministratore. |

Errori di intestazione della richiesta

Tutte le chiamate API in 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, consulta l’ esercitazione sull’autenticazione. Se una di queste intestazioni è mancante o non è valida durante una chiamata API, potrebbero verificarsi i seguenti errori.

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. Assicurati che l’intestazione Autorizzazione sia inclusa con un token di accesso valido prima di riprovare.

Il 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. Assicurati che il token sia stato immesso correttamente oppure genera un nuovo token nella console Adobe I/O.

Chiave API obbligatoria

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

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

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 fornita (x-api-key) non è valido. Assicurati di aver immesso correttamente la chiave prima di riprovare. Se non conosci la tua chiave API, puoi trovarlo 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 IMS (x-gw-ims-org-id) da una richiesta API. Assicurati che l’intestazione sia inclusa con l’ID della tua organizzazione IMS prima di riprovare.

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 a effettuare chiamate alle API Experience Platform per l’organizzazione IMS fornita nell’intestazione x-gw-ims-org-id . 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: nella scheda Integrazioni , passa alla sezione Panoramica per una specifica integrazione e trova l'ID in Credenziali client.

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 ha un'intestazione Content-Type non valida o mancante. Verifica che l’intestazione sia inclusa nella richiesta e che il relativo valore sia application/json.

Directory dei servizi per la risoluzione dei problemi

Di seguito è riportato un elenco delle guide per la risoluzione dei problemi e della 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 dei singoli servizi Platform. 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.

Servizio Riferimento API Risoluzione dei problemi
Controllo dell'accesso API di controllo accessi Guida alla risoluzione dei problemi di controllo degli accessi
Acquisizione dei dati in Adobe Experience Platform Data Ingestion API Guida

alla risoluzione dei problemi di inserimento in batchGuida alla risoluzione dei problemi di acquisizione in streaming
Adobe Experience Platform Data Science Workspace Sensei Machine Learning API Data Science Workspace guida alla risoluzione dei problemi
Governance dei dati di Adobe Experience Platform Policy Service API
Servizio Adobe Experience Platform Identity Identity Service API Identity Service guida alla risoluzione dei problemi
Servizio query di Adobe Experience Platform Query Service API Query Service guida alla risoluzione dei problemi
Segmentazione di Adobe Experience Platform Segmentation API
Catalog Service Catalog Service API
Experience Data Model (XDM) Schema Registry API XDM System Domande frequenti e guida alla risoluzione dei problemi
Flow Service (Sources e Destinations) Flow Service API
Real-time Customer Profile Real-time Customer Profile API Profile guida alla risoluzione dei problemi
Sandbox API sandbox Guida alla risoluzione dei problemi delle sandbox

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now