Per mantenere una stabilità e prestazioni ottimali del sistema, Connessione Salute impone limiti di frequenza alle connessioni client all'API Connessione Salute.
Questa guida delinea i limiti imposti alle operazioni API di lettura e scrittura in Connessione Salute e spiega come evitare la limitazione della frequenza attraverso una progettazione efficiente dell'app.
Limiti dell'API
Per le operazioni API in primo piano e in background vengono applicati limiti come quote di frequenza di richieste fisse.
I limiti di frequenza e di memoria sono variabili in base al tipo di operazione eseguita dall'app e al fatto che l'operazione avvenga in primo piano o in background.
Limiti di lettura e log delle modifiche
Per i limiti di lettura e log delle modifiche, Connessione Salute impone due limiti al numero di chiamate API disponibili per la tua app:
- Un limite periodico al numero di chiamate API che la tua app può effettuare all'API.
- Un limite giornaliero al numero di chiamate API che la tua app può effettuare.
Inserisci, aggiorna ed elimina limiti
Connessione Salute impone quattro limiti distinti per le operazioni di inserimento, aggiornamento ed eliminazione:
- Un limite periodico al numero di chiamate che la tua app può effettuare all'API.
- Un limite giornaliero al numero di chiamate che la tua app può effettuare all'API.
- Un limite di memoria per gli inserimenti collettivi.
- Un limite di memoria per gli inserimenti di singoli record.
Best practice
Consigliamo alle app di interagire con l'API Health Connect in modo da ridurre al minimo l'utilizzo della batteria, mantenere l'integrità del sistema ottimale e promuovere una gestione efficiente dei dati in tutte le operazioni CRUD.
Di seguito sono riportate alcune linee guida sulle best practice da rispettare.
Chiamate API in background
L'utilizzo della batteria per le operazioni in background riduce l'esperienza utente e solleva domande sulla privacy dei dati.
Di conseguenza, la limitazione della frequenza in background è più rigida di quella in primo piano. È quindi importante limitare il numero di chiamate API eseguite dall'app in background.
Gestione eccezioni
Se si verifica un'eccezione per la tua app durante la scrittura di dati in Connessione Salute, ti consigliamo di riprovare dal punto in cui si è verificata l'eccezione.
Non limitarti a eliminare tutti i dati in questione e riprova a eseguire l'intera richiesta di scrittura. Questo approccio compromette la quota di inserimento, riduce le prestazioni e ha un impatto negativo sulla durata della batteria.
Gestione del log delle modifiche
Per ridurre al minimo il rischio di limitazione di frequenza della tua app, ti consigliamo di utilizzare la gestione dei log delle modifiche per sincronizzare il database con i dati di Connessione Salute, anziché fare un uso eccessivo di richieste di lettura non elaborate.