Per mantenere stabilità e prestazioni ottimali del sistema, Connessione Salute impone limiti di frequenza alle connessioni client all'API Health Connect.
Questa guida descrive i limiti imposti alle operazioni API di lettura e scrittura in Connessione Salute e come evitare la limitazione della frequenza tramite una progettazione efficiente delle app.
Limiti dell'API
I limiti vengono applicati sia alle operazioni API in primo piano che a quelle in background come quote di frequenza delle richieste fisse.
I limiti di frequenza e di memoria variano in base al tipo di operazione eseguita dall'app e al fatto che l'operazione venga eseguita in primo piano o in background.
Limiti di lettura e changelog
Per i limiti di lettura e changelog, 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.
Limiti di inserimento, aggiornamento ed eliminazione
Connessione Salute impone quattro limiti distinti alle 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 l'inserimento 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 un'integrità ottimale del sistema e promuovere una gestione efficiente dei dati in tutte le operazioni CRUD.
Di seguito sono riportate alcune linee guida per le best practice da seguire.
Chiamate API in background
L'utilizzo della batteria per le operazioni in background riduce l'esperienza utente e solleva dubbi in merito alla privacy dei dati.
Pertanto, la limitazione della frequenza in background è più rigorosa di quella in primo piano. È quindi importante limitare il numero di chiamate API eseguite dalla tua app in background.
Gestione delle eccezioni
Se la tua app rileva un'eccezione durante la scrittura dei dati su Connessione Salute, ti consigliamo di riprovare dal punto in cui si è verificata l'eccezione.
Non eliminare tutti i dati in questione e riprova l'intera richiesta di scrittura. Questo approccio riduce la quota di inserimento, le prestazioni e ha un impatto negativo sulla durata della batteria.
Gestione del log delle modifiche
Per ridurre al minimo il rischio che la tua app venga limitata, devi utilizzare la gestione del log delle modifiche per sincronizzare il database con i dati di Connessione Salute, anziché fare eccessivo affidamento sulle richieste di lettura non elaborate.