Gestione degli errori
Quando si verifica un problema durante una chiamata all’API di Reactor, può essere restituito un errore in uno dei seguenti modi:
- Errori immediati: quando si esegue una richiesta che genera un errore immediato, l’API restituisce una risposta di errore, con lo stato HTTP che riflette il tipo generale di errore che si è verificato.
- Errori ritardati: quando si esegue una richiesta API che causa un errore ritardato (ad esempio un’attività asincrona), l’API potrebbe restituire un errore in
meta.status_details
di una risorsa correlata.
Formato degli errori
Le risposte di errore mirano a conformarsi alle specifiche degli errori JSON:API e in genere si attengono alla seguente struttura:
{
"errors": [
{
"id": "8a5526da-ab12-4be9-b084-2efe537f388c",
"status": "404",
"code": "not-found",
"title": "Record Not Found",
"meta": {
"request_id": "jfb0dQ2e0XVTkQ6AOfEJFfTDjguw9x3d"
},
"source": {
"pointer": "/data"
}
}
]
}
Proprietà
Descrizione
id
Identificatore univoco per questa particolare occorrenza del problema.
status
Codice di stato HTTP applicabile a questo problema, espresso come valore stringa.
code
Codice di errore specifico per l’applicazione, espresso come valore stringa.
title
Riepilogo breve e leggibile del problema, che non deve cambiare da occorrenza a occorrenza, a meno che non sia a scopo di localizzazione.
detail
Spiegazione leggibile specifica per questa occorrenza del problema. Come
title
, il valore di questo campo può essere localizzato.source
Oggetto contenente riferimenti all’origine dell’errore, facoltativamente con uno o più dei seguenti membri:
pointer
: una stringa JSON Pointer (RFC6901) che fa riferimento all’entità associata nel documento della richiesta (ad esempio/data
per un oggetto dati principale o/data/attributes/title
per un attributo specifico).
meta
Oggetto contenente metadati non standard sull’errore.
Descrizione degli errori
Nella tabella seguente sono elencati i diversi errori che l’API può restituire.
Titolo dell’errore
Descrizione
authentication-failure
Il token di accesso IMS non è valido. Per ottenere un nuovo token di accesso, accedi nuovamente. Oppure per gli account tecnici, genera di un nuovo JWT e scambialo per un token di accesso IMS.
connection-refused
Impossibile stabilire una connessione al server.
decrypt-bad-passphrase
Impossibile decrittografare i dati con la passphrase fornita.
decrypt-failed
Impossibile decrittografare i dati con la chiave privata fornita. Assicurati che la chiave funzioni localmente e che non contenga spazi vuoti.
decrypt-no-data
I dati non possono essere decrittografati senza una chiave privata. Fornisci una chiave privata crittografata.
delegate-descriptor-unresolved
L’estensione non ha fornito la definizione prevista di questo descrittore di delegato. Potrebbe essere necessario aggiornare l’estensione.
deleted-resources
Le risorse che stai tentando di aggiungere alla libreria sono state eliminate.
environment-in-use
A ogni ambiente può essere assegnata una sola libreria alla volta. L’opzione 1 consiste nel scegliere un ambiente diverso. L’opzione 2 consiste nel liberare l’ambiente spostando la libreria in un altro ambiente o eliminandola.
environment-required
Prima di poter creare una build, deve essere assegnato un ambiente alla libreria.
extension-not-found
L’estensione che definisce un elemento dati o un componente regola non è inclusa nella libreria. Verifica che tutte le estensioni richieste siano state aggiunte alla libreria.
extension-package-path-error
Un percorso definito in extension.json non è stato costruito correttamente.
extension-package-transform-definition-error
È stata definita una trasformazione non valida per una proprietà oggetto. Ogni proprietà oggetto può avere una trasformazione definita, che deve essere di tipo di file o funzione.
extension-package-zip-error
Errore durante la decompressione di ExtensionPackage o la creazione dell’archivio zip dei file per la distribuzione.
host-in-use
Un host non può essere eliminato se uno o più ambienti lo utilizzano.
host-required
L’ambiente assegnato a questa libreria non dispone di un host valido. Controlla quale ambiente è assegnato alla libreria. Quindi assegna un host valido a tale ambiente.
host-type-error
Solo gli host SFTP richiedono la verifica delle credenziali prima di poter essere utilizzati, quindi il pre-test è disponibile solo per quel tipo di host.
illegal-custom-code-transform
Non è consentito utilizzare la trasformazione customCode. Specifica una trasformazione di tipo funzione o file.
ims-not-authorized
Errore sconosciuto durante l’autorizzazione dell’account. Riprova più tardi.
ims-session-error
Si è verificato un problema con la sessione di accesso. Esci e accedi di nuovo.
internal-error
Errore interno. Attendi alcuni minuti e riprova. Se il problema persiste, contatta l’Assistenza clienti.
invalid-data_element
Non è possibile aggiungere un elemento dati non valido a una libreria.
invalid-embed_code
Il codice di incorporamento non è valido oppure si sta tentando di collegarlo a un ambiente di sviluppo o di staging. I codici di incorporamento Dynamic Tag Management (DTM) possono essere collegati solo agli ambienti di produzione.
invalid-extension
Non è possibile aggiungere un’estensione non valida a una libreria.
invalid-extension_package_id
Puoi modificare solo alcune proprietà dell’oggetto di un pacchetto di estensione. Hai provato a modificare uno di quelli non consentiti.
invalid-new-owner-org-id
L’ID organizzazione che hai tentato di assegnare non è un ID organizzazione valido.
invalid-org
La tua organizzazione attiva non ha accesso all’API. Verifica di utilizzare l’organizzazione corretta.
invalid-rule
Impossibile aggiungere una regola non valida a una libreria.
invalid-settings-syntax
Errore di sintassi durante l’analisi delle impostazioni JSON.
library-file-not-found
Impossibile trovare un file necessario definito in extension.json all’interno del pacchetto zip.
minification-error
Impossibile compilare il codice. Codice non valido.
multiple-revisions
È possibile includere in una libreria una sola revisione di ogni risorsa.
no-available-orgs
Questo account utente non appartiene a un profilo di prodotto con accesso ai tag. Utilizza Admin Console per aggiungere questo utente a un profilo di prodotto con diritti di tag.
not-authorized
Questo account utente non dispone delle autorizzazioni necessarie per eseguire questa azione.
not-found
Impossibile trovare il record. Verifica l’ID dell’oggetto che stai tentando di recuperare.
not-unique
Il nome che stai cercando di utilizzare è già in uso. Per questa risorsa, la proprietà “name” deve essere univoca.
public-release-not-authorized
La versione pubblica delle estensioni è coordinata da
launch-ext-dev@adobe.com
. Per ulteriori informazioni, consulta il documento sul rilascio di estensioni.read-only
La risorsa è di sola lettura e non può essere modificata.
session-timeout
La sessione utente è scaduta. Esci e accedi di nuovo.
sftp-authentication-failed
Autenticazione non riuscita per la connessione SFTP.
sftp-connection-timeout
Timeout della connessione SFTP.
sftp-exception
Eccezione durante l’utilizzo di SFTP per la connessione al server.
sftp-status-exception
Eccezione SFTP durante il tentativo di comunicazione con il server.
socket-error
Errore del socket durante il tentativo di comunicazione con il server.
ssh-disconnect
La sessione SSH è stata disconnessa.
timeout-error
Timeout della connessione con il server.
unknown-error
Errore imprevisto. Riprova più tardi oppure chiama l’Assistenza clienti e spiega cosa stavi facendo quando si è verificato l’errore.
unsupported-custom-code-language
È stato fornito un linguaggio di codice personalizzato non supportato.
upgraded-extension-required
Dopo aver installato un aggiornamento dell’estensione, devi includerlo in tutte le librerie fino a quando l’aggiornamento non arriva a Produzione. L’unica eccezione è se l’estensione non è ancora stata pubblicata.
upstream-build-required
È necessaria una build corretta per la libreria a monte prima di poterla generare.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743