Best practice per l’integrazione di Marketo
Progetta integrazioni in base ai limiti dell’API condivisa per l’istanza Marketo. Utilizza la gestione degli hit in batch, la memorizzazione in cache e tassi di richiesta prudenti per migliorare la velocità effettiva e l’affidabilità.
Limiti API
- Quota giornaliera: alla maggior parte degli abbonamenti sono assegnate 50.000 chiamate API al giorno. La quota viene ripristinata ogni giorno alle 00:00 CST. Contatta il tuo account manager per aumentare la quota giornaliera.
- Limite di frequenza: Ogni istanza è limitata a 100 chiamate API in 20 secondi.
- Limite di concorrenza: Ogni istanza consente un massimo di dieci chiamate API simultanee.
- Dimensione batch: il database lead supporta 300 record; Asset Query supporta 200 record.
- Dimensione payload REST API: 1 MB.
- Dimensione file di importazione in blocco: 10 MB.
- Dimensione batch massima SOAP: 300 record.
- Processi di estrazione in blocco: due in esecuzione e dieci in coda, inclusi.
Suggerimenti
- Impostare limiti di utilizzo prudenti perché l’applicazione condivide le risorse relative a quote, tassi e concorrenza con altre applicazioni.
- Se disponibili, utilizza i metodi batch e di massa di Marketo. Utilizza le chiamate a record singolo o risultato singolo solo quando necessario.
- Utilizza backoff esponenziale per ritentare le chiamate API che non riescono a causa dei limiti di frequenza o concorrenza.
- Evita le chiamate API simultanee a meno che non vadano a beneficio del tuo caso d’uso.
Batch
Per gli inserimenti e gli aggiornamenti, raggruppare i record nel minor numero possibile di transazioni. Quando si recuperano record da un archivio dati, aggregarli prima dell’invio anziché inviare una richiesta per ogni modifica.
Latenza accettabile
Definisci la latenza accettabile (il tempo massimo prima di inviare una chiamata API) durante la progettazione di un’integrazione. Questa scelta determina i metodi e le opzioni di configurazione di Marketo adatti al caso d’uso.
Ad esempio, un’integrazione in tempo reale che invia una notifica al venditore all’avvio di una versione di prova potrebbe inviare batch di una quando è necessario un follow-up immediato. La maggior parte dei casi d’uso tollera una maggiore latenza e funziona in modo più efficiente accodando e batch le chiamate.
Limiti giornalieri
Ogni istanza di Marketo abilitata per le API dispone di un’allocazione giornaliera di almeno 10.000 chiamate REST API, anche se 50.000 o più sono comuni. Ogni istanza dispone anche di 500 MB o più di capacità di estrazione in blocco. È possibile acquistare ulteriore capacità giornaliera come parte di un abbonamento Marketo, ma le progettazioni delle applicazioni devono tenere conto dei limiti comuni di abbonamento.
La capacità è condivisa da tutti i servizi API e dagli utenti in un’istanza. Eliminare le chiamate ridondanti e i record batch nel minor numero possibile di chiamate.
Il metodo di importazione più efficiente per le chiamate è l’API di importazione in blocco Marketo, disponibile per lead/persone e oggetti personalizzati. Marketo fornisce anche l’estrazione in blocco per lead e attività.
Memorizzazione in cache
I risultati delle seguenti operazioni possono in genere essere memorizzati nella cache lato client per un giorno o più, in quanto vengono modificati raramente:
- Risultati delle operazioni Describe
- Tipi di attività
- Partizioni
Per casi d’uso come l’arricchimento dei dati di lead o attività, puoi anche memorizzare in cache tipi di risorse come programmi, e-mail e cartelle.
Limite di velocità
Ogni istanza di Marketo ha un limite di velocità condivisa di 100 chiamate ogni 20 secondi in tutti i servizi API di terze parti. Se le chiamate superano questo limite, l’API restituisce un codice di errore 606.
In generale, limita ogni integrazione di terze parti a 50 chiamate per 20 secondi o meno, in modo che più integrazioni API e utenti possano condividere la capacità disponibile. Per alcuni casi di utilizzo potrebbe essere necessario il limite completo. Tuttavia, le applicazioni che utilizzano la gestione in batch e il throughput di destinazione sono generalmente più reattive e coerenti, con un lieve aumento della latenza.
Limite concorrenza
Ogni istanza di Marketo ha un limite condiviso di dieci chiamate API REST in esecuzione simultanea. Non presumere che l’applicazione sia l’unico consumatore di questo limite.
Marketo conta le chiamate in elaborazione che non sono ancora state restituite. Quando viene restituita una chiamata, questa non viene più conteggiata nel limite di concorrenza.
La maggior parte delle integrazioni non beneficia di chiamate simultanee. Se implementi la concorrenza, limita inizialmente l’applicazione a cinque o meno richieste simultanee. Aumentare il limite solo dopo aver stabilito che l’applicazione richiede di più.
Errori
Tranne in rari casi, le richieste API restituiscono il codice di stato HTTP 200. Anche gli errori di logica di business restituiscono 200, ma includono i dettagli nel corpo della risposta. Per ulteriori informazioni, vedere Codici errore.
Non valutare la frase del motivo HTTP perché è facoltativa e soggetta a modifiche.