Bonnes pratiques d’intégration de Marketo
Concevez des intégrations autour des limites d’API partagées pour votre instance Marketo. Utilisez les taux de traitement par lots, de mise en cache et de requête prudents pour améliorer le débit et la fiabilité.
Limites d’API
- Quota quotidien : la plupart des abonnements reçoivent 50 000 appels d’API par jour. Le quota est réinitialisé tous les jours à 00:00 CST. Contactez votre gestionnaire de compte pour augmenter le quota quotidien.
- Limite de débit : chaque instance est limitée à 100 appels API par période de 20 secondes.
- Limite de simultanéité : chaque instance autorise un maximum de dix appels d’API simultanés.
- Taille du lot : la base de données de lead prend en charge 300 enregistrements ; la requête de ressource prend en charge 200 enregistrements.
- Taille de la payload de l’API REST : 1 Mo.
- Taille du fichier d’importation en bloc : 10 Mo.
- Taille de lot maximale de SOAP : 300 enregistrements.
- Tâches d’extraction en bloc : deux en cours d’exécution et dix en file d’attente, inclus.
Conseils rapides
- Définissez des limites d’utilisation conservatrices, car votre application partage des ressources de quota, de taux et de simultanéité avec d’autres applications.
- Utilisez les méthodes Marketo par lot et par lot si elles sont disponibles. Utilisez des appels à enregistrement unique ou à résultat unique uniquement lorsque cela est nécessaire.
- Utilisez l’exponential backoff pour réessayer les appels API qui échouent en raison de limites de taux ou de simultanéité.
- Évitez les appels API simultanés, sauf s’ils bénéficient à votre cas d’utilisation.
Traitement par lots
Pour les insertions et mises à jour, regroupez les enregistrements en aussi peu de transactions que possible. Lors de la récupération d’enregistrements d’un magasin de données, agrégez-les avant l’envoi au lieu d’envoyer une seule demande pour chaque modification.
Latence acceptable
Définissez la latence acceptable (durée maximale avant l’envoi d’un appel API) lorsque vous concevez une intégration. Ce choix détermine les méthodes Marketo et les options de configuration qui correspondent au cas d’utilisation.
Par exemple, une intégration en temps réel qui avertit un vendeur lorsqu’un utilisateur ou une utilisatrice commence une évaluation peut envoyer des lots d’un lot lorsqu’un suivi immédiat est requis. La plupart des cas d’utilisation tolèrent une latence plus élevée et fonctionnent plus efficacement en mettant les appels en file d’attente et par lots.
Limites quotidiennes
Chaque instance Marketo compatible avec les API dispose d’une allocation quotidienne d’au moins 10 000 appels API REST, bien que 50 000 appels ou plus soient courants. Chaque instance dispose également d’une capacité d’extraction en bloc de 500 Mo ou plus. Une capacité quotidienne supplémentaire peut être achetée dans le cadre d’un abonnement à Marketo, mais les conceptions d’application doivent tenir compte des limites d’abonnement courantes.
La capacité est partagée par tous les services d’API et les utilisateurs d’une instance. Éliminez les appels redondants et les enregistrements par lots en le réduisant au minimum.
La méthode d’importation la plus efficace pour les appels est l’API d’importation en bloc Marketo, disponible pour les prospects/personnes et objets personnalisés. Marketo fournit également l’extraction en bloc pour les prospects et activités.
Mise en cache
Les résultats des opérations suivantes peuvent généralement être mis en cache côté client pendant un jour ou plus, car ils changent rarement :
- Résultats des opérations de description
- Types d’activité
- Partitions
Pour les cas d’utilisation tels que l’enrichissement des données de prospect ou d’activité, vous pouvez également mettre en cache des types de ressources tels que des programmes, des e-mails et des dossiers.
Limite de débit
Chaque instance Marketo a une limite de débit partagé de 100 appels par 20 secondes sur tous les services d’API tiers. Si les appels dépassent cette limite, l’API renvoie un code d’erreur 606.
En règle générale, limitez chaque intégration tierce à 50 appels par 20 secondes ou moins afin que plusieurs intégrations d’API et utilisateurs puissent partager la capacité disponible. Certains cas d’utilisation peuvent nécessiter la limite complète. Toutefois, les applications qui utilisent le traitement par lots et ciblent un débit plus faible sont généralement plus réactives et cohérentes, avec une légère augmentation de la latence.
Limite de simultanéité
Chaque instance Marketo a une limite partagée de dix appels d’API REST exécutés simultanément. Ne supposez pas que votre application est le seul consommateur de cette limite.
Marketo comptabilise les appels en cours de traitement qui n’ont pas encore été renvoyés. Lorsqu’un appel est renvoyé, il n’est plus comptabilisé dans la limite de simultanéité.
La plupart des intégrations ne bénéficient pas d’appels simultanés. Si vous implémentez la simultanéité, limitez d’abord l’application à cinq requêtes simultanées ou moins. Augmentez la limite uniquement après avoir déterminé que l’application en nécessite davantage.
Erreurs
Sauf dans de rares cas, les requêtes API renvoient le code d’état HTTP 200. Les erreurs de logique commerciale renvoient également 200, mais incluent des détails dans le corps de la réponse. Voir Codes d’erreur pour plus d’informations.
N’évaluez pas l’expression de raison HTTP, car elle est facultative et peut être modifiée.