L'API di Oura semplifica l'accesso ai dati generati dall'anello Oura. Per utilizzare l'API di Oura, è necessario avere un account Oura e un token di accesso personale o un'applicazione API.
Che cos'è l'API di Oura
Come usare l'API di Oura
Come generare token di accesso personali
Come usare i token di accesso personali
Ulteriori informazioni
Che cos'è l'API di Oura
L'API di Oura può essere usata per raccogliere i dati di Oura o creare un'integrazione per consentire agli utenti la condivisione dei dati di Oura con un servizio di terze parti.
L'API Oura V1 è stata rilasciata nel 2016 e l'API Oura V2 è stata rilasciata nel gennaio 2022. Il supporto per V1 è stato interrotto all'inizio del 2023.
Come usare l'API di Oura
La documentazione completa per Oura API V2 è disponibile qui.
Gli utenti dell'anello Oura Gen3 senza un abbonamento Oura attivo non potranno più accedere ai propri dati tramite l'API di Oura. Inoltre, le applicazioni dei partner integrate con l'API di Oura non avranno più accesso ai dati degli utenti di anelli Oura Gen3 che non dispongono più di un abbonamento Oura. Gli utenti Oura potranno però continuare a scaricare i propri file di dati tramite Oura Web. Questi file di dati dovranno essere in conformità almeno ai requisiti minimi richiesti dal GDPR.
Gli utenti Oura dovranno aver effettuato l'aggiornamento a una versione recente dell'app di Oura per mobile per poter supportare i tipi di dati disponibili tramite Oura API V2.
I token di accesso esistenti dell'API di Oura V1 rimarranno validi per l'uso con l'API di Oura V2 per le informazioni personali, l'attività giornaliera, la prontezza giornaliera, il sonno giornaliero e i dati relativi all'ora di dormire. I token di accesso esistenti dell'API di Oura V1 non avranno accesso ai nuovi tipi di dati disponibili attraverso l'API di Oura V2, compresi la frequenza cardiaca diurna, la frequenza cardiaca di allenamento, gli allenamenti, i tag, le sessioni e altri tipi di dati che saranno rilasciati in futuro. Per accedere a nuovi tipi di dati forniti dall'API di Oura V2, puoi creare nuovi token di accesso personali o chiedere agli utenti di acconsentire a nuovi ambiti di dati tramite il flusso di autorizzazione OAuth.
Gli utenti di anelli Oura Gen2 non subiranno variazioni in termini di disponibilità dei propri dati tramite l'API di Oura.
Come generare i token di accesso personali
Oura offre anche token di accesso personali per facilitare l’integrazione con l'API cloud di Oura. Questi token di accesso personali facilitano l'integrazione per gli sviluppatori che desiderano recuperare programmaticamente i dati Oura dall'API Cloud di Oura. Attualmente non forniamo token di accesso di gruppo.
Per iniziare con i token di accesso personali, attieniti alla seguente procedura:
- Apri la pagina dei token di accesso personali.
- Fai clic su "Crea un nuovo token di accesso personale" nell’angolo in alto a destra della pagina
- Inserisci una nota univoca per il nuovo token di accesso personale che stai creando
- Fai clic su "Crea token di accesso personale" per inviare il modulo e creare il tuo nuovo token di accesso personale.
Ora dovresti avere un nuovo token di accesso attivo, visualizzabile nella pagina Token di accesso personali.
Assicurati di copiare questo nuovo token, in quanto non sarà possibile visualizzarlo una volta lasciata questa pagina. Fai clic su Copia per copiare il valore del token negli appunti.
Come usare i token di accesso personali
Una volta ottenuto il tuo token di accesso personale, puoi utilizzarlo per accedere all'API di Oura. Esistono due modi di fornire il token di accesso personale:
-
HTTP header: inserisci il token di accesso personale nell'header dell'autorizzazione come segue:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
Parametro URL: aggiungi il parametro access_token alla call API:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
I tuoi token di accesso personale possono essere revocati in qualunque momento.
