Codici errore

Le API REST di Marketo restituiscono errori a livello HTTP, di risposta o di record. In questa pagina vengono illustrati i tipi di errore e i codici di errore associati.

Gestione e registrazione delle eccezioni

Registra le richieste e le risposte quando l’integrazione rileva un’eccezione imprevista. Alcune eccezioni, ad esempio l’autenticazione scaduta, possono essere gestite effettuando di nuovo l’autenticazione. Altre eccezioni possono richiedere l’assistenza del Supporto tecnico, che richiederà i dettagli di richiesta e risposta associati.

Tipi di errore

L’API REST di Marketo può restituire tre tipi di errori durante il normale funzionamento:

Gli errori a livello di risposta e di record restituiscono il codice di stato HTTP 200. Per tutti i tipi di errore, non valutare la frase del motivo HTTP perché è facoltativa e soggetta a modifiche.

Errori a livello HTTP

Durante il normale funzionamento, Marketo restituisce due errori del codice di stato HTTP: 413 Request Entity Too Large e 414 Request URI Too Long. Per risolvere uno di questi errori, modifica la richiesta e riprova. Per evitare questi errori, controlla le dimensioni delle richieste prima dell’invio.

Marketo restituisce 413 quando il payload della richiesta supera 1 MB o 10 MB per l’importazione di lead. Controlla le dimensioni della richiesta prima dell’invio. Se i record causano il superamento del limite della richiesta, sposta tali record in un’altra richiesta.

Marketo restituisce 414 quando l’URI di una richiesta GET supera gli 8 KB. Controlla la lunghezza della stringa di query prima dell’invio. Se supera il limite, modifica il metodo di richiesta in POST, inserisci la stringa di query nel corpo della richiesta e aggiungi il parametro _method=GET. Gli URI lunghi sono più comuni quando si recuperano batch di record di grandi dimensioni con valori di filtro lunghi, ad esempio un GUID.

L’endpoint Identity può restituire un errore 401 Unauthorized, in genere perché l’ID client o il segreto client non è valido. Nella tabella seguente sono elencati i codici di errore a livello HTTP.

Errori a livello di risposta

Gli errori a livello di risposta si verificano quando la risposta imposta il parametro success su false. Utilizzano la seguente struttura:

{
    "requestId": "e42b#14272d07d78",
    "success": false,
    "errors": [
        {
            "code": "601",
            "message": "Unauthorized"
        }
    ]
}

Ogni oggetto nella matrice “errors” contiene due membri:

Un codice 6xx indica che l’intera richiesta non è riuscita e non è stata eseguita. Ad esempio, recupera da un errore 601 “Token di accesso non valido” autenticando di nuovo e passando il nuovo token di accesso con la richiesta.

Un codice 7xx indica che la richiesta non è riuscita perché non sono stati restituiti dati o i parametri della richiesta non sono validi. Le cause includono una data non valida o un parametro obbligatorio mancante.

Codici di errore a livello di risposta

Record-Level record_level_errors

Gli errori a livello di record indicano che la richiesta era valida, ma non è stato possibile completare l’operazione per un singolo record. Una risposta con errori a livello di record segue il seguente schema:

Risposta

{
   "requestId":"e42b#14272d07d78",
   "success":true,
   "result":[
      {
         "id":50,
         "status":"created"
      },
      {
         "id":51,
         "status":"created"
      },
      {
         "status":"skipped",
         "reasons":[
            {
               "code":"1005",
               "message":"Lead already exists"
            }
         ]
      }
   ]
}

I record nella matrice dei risultati vengono visualizzati nello stesso ordine dei record nella matrice di input della richiesta. Ogni record può avere esito positivo o negativo in modo indipendente, come indicato dal relativo campo di stato.

Per un record non riuscito, il campo “status” è “skipped” e il record include un array “reason”. Ogni motivo contiene un membro “code” e un membro “message”. Il codice è sempre 1xxx e il messaggio spiega perché il record è stato ignorato.

Ad esempio, se una richiesta di sincronizzazione dei lead imposta “action” su “createOnly” ed esiste già un lead per una delle chiavi inviate, la risposta restituisce il codice 1005 e il messaggio “Lead exists,” come mostrato sopra.

Codici di errore a livello di record