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