78 lines
3.6 KiB
Markdown
78 lines
3.6 KiB
Markdown
# Oura
|
|
|
|
## Sync overview
|
|
|
|
This source can sync various data from the [Oura](https://ouraring.com/) ring.
|
|
It currently only supports authentication through personal access tokens, and
|
|
is therefore not suitable for syncing data from multiple Oura rings.
|
|
|
|
### Output schema
|
|
|
|
This source is capable of syncing the following streams:
|
|
|
|
- `daily_activity`
|
|
- `daily_readiness`
|
|
- `daily_sleep`
|
|
- `heart_rate`
|
|
- `sessions`
|
|
- `sleep_periods`
|
|
- `tags`
|
|
- `workouts`
|
|
|
|
### Features
|
|
|
|
| Feature | Supported? \(Yes/No\) | Notes |
|
|
|:------------------|:----------------------|:----------------------------------|
|
|
| Full Refresh Sync | Yes | |
|
|
| Incremental Sync | No | |
|
|
| Multiple rings | No | May be implemented in the future. |
|
|
|
|
### Performance considerations
|
|
|
|
There are no documented rate limits for the Oura V2 API at the time of writing.
|
|
However, users must have an up-to-date version of the Oura app installed to use
|
|
the API.
|
|
|
|
## Getting started
|
|
|
|
### Requirements
|
|
|
|
1. Purchase an Oura ring.
|
|
2. Create a personal access token via the
|
|
[Oura developer portal](https://cloud.ouraring.com/personal-access-tokens).
|
|
|
|
### Setup guide
|
|
|
|
The following fields are required fields for the connector to work:
|
|
|
|
- `api_key`: Your Oura API key.
|
|
- (optional) `start_datetime`: The start date and time for the sync.
|
|
- (optional) `end_datetime`: The end date and time for the sync.
|
|
|
|
## Changelog
|
|
|
|
<details>
|
|
<summary>Expand to review</summary>
|
|
|
|
| Version | Date | Pull Request | Subject |
|
|
|:--------|:-----------|:---------------------------------------------------------|:--------------------------------------------|
|
|
| 0.2.1 | 2024-10-28 | [47576](https://github.com/airbytehq/airbyte/pull/47576) | Update dependencies |
|
|
| 0.2.0 | 2024-08-19 | [44409](https://github.com/airbytehq/airbyte/pull/44409) | Refactor connector to manifest-only format |
|
|
| 0.1.14 | 2024-08-17 | [44271](https://github.com/airbytehq/airbyte/pull/44271) | Update dependencies |
|
|
| 0.1.13 | 2024-08-12 | [43788](https://github.com/airbytehq/airbyte/pull/43788) | Update dependencies |
|
|
| 0.1.12 | 2024-08-10 | [43633](https://github.com/airbytehq/airbyte/pull/43633) | Update dependencies |
|
|
| 0.1.11 | 2024-08-03 | [43287](https://github.com/airbytehq/airbyte/pull/43287) | Update dependencies |
|
|
| 0.1.10 | 2024-07-20 | [42356](https://github.com/airbytehq/airbyte/pull/42356) | Update dependencies |
|
|
| 0.1.9 | 2024-07-13 | [41850](https://github.com/airbytehq/airbyte/pull/41850) | Update dependencies |
|
|
| 0.1.8 | 2024-07-10 | [41519](https://github.com/airbytehq/airbyte/pull/41519) | Update dependencies |
|
|
| 0.1.7 | 2024-07-09 | [41264](https://github.com/airbytehq/airbyte/pull/41264) | Update dependencies |
|
|
| 0.1.6 | 2024-07-06 | [40951](https://github.com/airbytehq/airbyte/pull/40951) | Update dependencies |
|
|
| 0.1.5 | 2024-06-25 | [40450](https://github.com/airbytehq/airbyte/pull/40450) | Update dependencies |
|
|
| 0.1.4 | 2024-06-22 | [40097](https://github.com/airbytehq/airbyte/pull/40097) | Update dependencies |
|
|
| 0.1.3 | 2024-06-04 | [39072](https://github.com/airbytehq/airbyte/pull/39072) | [autopull] Upgrade base image to v1.2.1 |
|
|
| 0.1.2 | 2024-05-30 | [38399](https://github.com/airbytehq/airbyte/pull/38399) | [autopull] base image + poetry + up_to_date |
|
|
| 0.1.1 | 2024-05-28 | [38688](https://github.com/airbytehq/airbyte/pull/38688) | Make connector builder compatible |
|
|
| 0.1.0 | 2022-10-20 | [18224](https://github.com/airbytehq/airbyte/pull/18224) | New source |
|
|
|
|
</details>
|