Errori a livello HTTP
In circostanze operative normali, Marketo dovrebbe restituire solo due errori del codice di stato HTTP, 413 Request Entity Too Large e 414 Request URI Too Long. Entrambi possono essere recuperati recuperando l’errore, modificando la richiesta e riprovando, ma con le pratiche di codifica intelligente non dovresti mai incontrarli in modo selvaggio.
Marketo restituirà 413 se il payload della richiesta supera 1 MB, o 10 MB in caso di lead di importazione. Nella maggior parte degli scenari è improbabile che questi limiti vengano raggiunti, ma l’aggiunta di un controllo alle dimensioni della richiesta e lo spostamento di eventuali record, che causano il superamento del limite a una nuova richiesta, dovrebbe evitare qualsiasi circostanza che porti alla restituzione di questo errore da parte di qualsiasi endpoint.
414 verrà restituito quando l’URI di una richiesta GET supera gli 8 KB. Per evitarlo, confrontalo con la lunghezza della stringa di query per vedere se supera questo limite. Se la richiesta viene modificata in un metodo POST, immettere la stringa di query come corpo della richiesta con il parametro aggiuntivo _method=GET. In questo modo viene superata la limitazione sugli URI. È raro che questo limite venga raggiunto nella maggior parte dei casi, ma è piuttosto comune quando si recuperano grandi batch di record con valori di filtro singoli lunghi, ad esempio un GUID.
L'endpoint Identity può restituire un errore 401 Unauthorized. Ciò è in genere dovuto a un ID client non valido o a un segreto client non valido. Codici di errore a livello HTTP
Errori a livello di risposta
Gli errori a livello di risposta sono presenti quando il parametro success della risposta è impostato su false e sono strutturati nel modo seguente:
{
"requestId": "e42b#14272d07d78",
"success": false,
"errors": [
{
"code": "601",
"message": "Unauthorized"
}
]
}
Ogni oggetto nell'array "errors" ha due membri, code, che è un numero intero tra 601 e 799 e un message che fornisce il motivo plaintext dell'errore. I codici 6xx indicano sempre che una richiesta non è riuscita completamente e non è stata eseguita. Un esempio è un 601, "Token di accesso non valido", che è recuperabile autenticando nuovamente e passando il nuovo token di accesso con la richiesta. Gli errori 7xx indicano che la richiesta non è riuscita perché non sono stati restituiti dati o perché la richiesta non era parametrizzata correttamente, ad esempio includendo una data non valida o mancando un parametro obbligatorio.
Codici di errore a livello di risposta
Una chiamata API che restituisce questo codice di risposta non viene conteggiata rispetto alla quota giornaliera o al limite di tariffa.
| Codice di risposta | Descrizione | Commento |
|---|---|---|
| 502 | Gateway non valido | Errore restituito dal server remoto. Probabile timeout. La richiesta deve essere ritentata con un backoff esponenziale. |
| 601* | Token di accesso non valido | Nella richiesta è stato incluso un parametro Token di accesso, ma il valore non era un token di accesso valido. |
| 602* | Token di accesso scaduto | Il token di accesso incluso nella chiamata non è più valido a causa della scadenza. |
| 603 | Accesso negato | L’autenticazione è riuscita, ma l’utente non dispone di autorizzazioni sufficienti per chiamare questa API. [Autorizzazioni aggiuntive](custom-services.md) potrebbero dover essere assegnate al ruolo utente, oppure il Inserisco nell'elenco Consentiti per l'accesso API basato su IP potrebbe essere abilitato. |
| 604* | Timeout della richiesta | La richiesta era in esecuzione da troppo tempo (ad esempio, si sono verificati conflitti nel database) o superava il periodo di timeout specificato nell’intestazione della chiamata. |
| 605* | Metodo HTTP non supportato | GET non è supportato per l’endpoint di sincronizzazione dei lead. È necessario utilizzare POST. |
| 606 | Limite di velocità massimo "%s"; superato con in "%s" sec | Il numero di chiamate negli ultimi 20 secondi è stato superiore a 100 |
| 607 | Quota giornaliera raggiunta | Il numero di chiamate di oggi ha superato la quota dell’abbonamento (viene ripristinato ogni giorno alle 00:00 CST).>La quota si trova nel menu Admin->Web Services. Puoi aumentare la tua quota tramite il tuo account manager. |
| 608* | API temporaneamente non disponibile | |
| 609 | JSON non valido | Il corpo incluso nella richiesta non è un JSON valido. |
| 610 | Risorsa richiesta non trovata | L’URI nella chiamata non corrisponde a un tipo di risorsa API REST. Ciò è spesso dovuto a un URI di richiesta scritto in modo errato o formattato in modo errato |
| 611* | Errore di sistema | Tutte le eccezioni non gestite |
| 612 | Tipo di contenuto non valido | Se visualizzi questo errore, aggiungi alla richiesta un’intestazione di tipo di contenuto che specifica il formato JSON. Ad esempio, prova a utilizzare "content type: application/json". Per ulteriori dettagli, vedere la domanda StackOverflow. |
| 613 | Richiesta multipart non valida | Il contenuto multipart del POST non è stato formattato correttamente |
| 614 | Sottoscrizione non valida | Impossibile trovare la sottoscrizione di destinazione oppure la sottoscrizione non è raggiungibile. Questo in genere indica un’inaccessibilità temporanea. |
| 615 | Limite di accesso simultaneo raggiunto | Al massimo, le richieste vengono elaborate da qualsiasi abbonamento 10 alla volta. Viene restituito se sono già presenti 10 richieste in corso. |
| 616 | Tipo di sottoscrizione non valido | Per accedere all’API dei metadati dell’oggetto personalizzato è necessario il tipo di abbonamento Marketo appropriato. Per informazioni, consulta il tuo CSM. |
| 701 | %s non può essere vuoto | Il campo segnalato nella richiesta non può essere vuoto |
| 702 | Nessun dato trovato per un dato scenario di ricerca | Nessun record corrisponde ai parametri di ricerca specificati. Nota: molte operazioni di ricerca non riuscite restituiscono "success = true" e nessun errore e impostano una stringa informativa di avvisi. |
| 703 | La funzione non è abilitata per la sottoscrizione | Funzione beta non abilitata in nell’abbonamento di un utente |
| 704 | Formato data non valido |
|
| 709 | Violazione di una regola business |
La chiamata non può essere soddisfatta perché viola il requisito di creare o aggiornare una risorsa, ad esempio se si tenta di creare un messaggio e-mail senza un modello. È inoltre possibile ricevere questo errore quando si tenta di:
|
| 710 | Cartella padre non trovata | Impossibile trovare la cartella principale specificata |
| 711 | Tipo di cartella non compatibile | La cartella specificata non è del tipo corretto per soddisfare la richiesta |
| 712 | Operazione di unione a persona Account non valida | Chiamata Unisci lead non riuscita a causa di un tentativo di unione di lead che sono account persona Salesforce. Gli account persona Salesforce devono essere uniti in Salesforce. |
| 713 | Errore transitorio | Al momento della chiamata API una risorsa di sistema non era temporaneamente disponibile. Quando si verifica questo errore, si consiglia di attendere e riprovare la richiesta. |
| 714 | Impossibile trovare il tipo di record predefinito | Chiamata di unione lead non riuscita. Impossibile trovare un tipo di record predefinito. |
| 718 | ExternalSalesPersonID non trovato | È stata effettuata una chiamata Sync Opportunities con un valore "ExternalSalesPersonID" inesistente. |
| 719 | Eccezione di timeout di attesa del blocco | È stata effettuata una chiamata al programma Clone ed è stato eseguito il timeout in attesa di un blocco. |