Pour assurer la stabilité et les performances optimales du système, Santé Connect impose des limites de débit aux connexions client à l'API Santé Connect.
Ce guide décrit les limites imposées aux opérations d'API en lecture et en écriture dans Santé Connect, et explique comment éviter la limitation du débit grâce à une conception d'application efficace.
Limites d'API
Les limites sont appliquées au niveau des opérations d'API au premier plan et en arrière-plan en tant que quotas de taux de requêtes fixes.
Les limites de débit et de mémoire varient en fonction du type d'opération effectué par votre application et de son type d'exécution (au premier plan ou en arrière-plan).
Limites de lecture et limites de journaux de modifications
Pour les limites de lecture et les limites de journaux de modifications, Santé Connect impose deux limites sur le nombre d'appels d'API disponibles pour votre application :
- Limite périodique du nombre d'appels d'API que votre application peut effectuer vers l'API
- Limite quotidienne du nombre d'appels d'API que votre application peut effectuer
Limites d'insertion, de mise à jour et de suppression
Santé Connect appique quatre limites distinctes aux opérations d'insertion, de mise à jour et de suppression :
- Limite périodique du nombre d'appels que votre application peut envoyer à l'API
- Limite quotidienne du nombre d'appels que votre application peut envoyer à l'API
- Limite de mémoire pour les insertions groupées
- Limite de mémoire pour les insertions d'enregistrement unique
Bonnes pratiques
Il est conseillé que les applications interagissent avec l'API Santé Connect de manière à réduire l'utilisation de la batterie, à optimiser l'état du système et à gérer efficacement les données pour toutes les opérations CRUD.
Voici quelques bonnes pratiques à suivre.
Appels d'API en arrière-plan
L'utilisation de la batterie pour les opérations en arrière-plan affecte l'expérience utilisateur et soulève des questions concernant la confidentialité des données.
Par conséquent, la limitation du débit en arrière-plan est plus stricte que la limitation du débit au premier plan. Il est donc important de limiter le nombre d'appels d'API en arrière-plan.
Gestion des exceptions
Si votre application rencontre une exception lors de l'écriture de données dans Santé Connect, nous vous recommandons de réessayer.
Ne vous contentez pas de supprimer toutes les données en question et de relancer la requête d'écriture. Cette approche consomme des ressources de votre quota d'insertion, réduit les performances et a un impact négatif sur l'autonomie de la batterie.
Gestion des journaux de modifications
Pour réduire le risque de limitation du débit de votre application, tirez profit de la gestion des journaux de modifications pour synchroniser votre base de données avec les données de Santé Connect, plutôt que de vous appuyer sur des requêtes de lecture brutes.