Cardiacsense icon

Cardiacsense

Interact with Cardiacsense FHIR API for cardiac and health monitoring data
Join our community

Actions26

Overview

This node integrates with the Cardiacsense FHIR API to retrieve heart rate data and other cardiac-related health metrics. Specifically, for the Heart Rate Data resource and the Get 8-Hour Mean operation, it fetches averaged heart rate measurements over a specified time interval (defaulting to an 8-hour window). This is useful in clinical or personal health monitoring scenarios where understanding average heart rate trends over extended periods helps assess cardiovascular health or detect anomalies.

Practical examples include:

  • Monitoring a patient's average heart rate during sleep or rest periods.
  • Tracking changes in heart rate averages before and after medication or treatment.
  • Aggregating heart rate data from specific devices like the CardiacSense Watch for remote patient monitoring.

Properties

Name Meaning
Patient Email Email address of the patient whose heart rate data is being requested.
Start Time Start date/time for the data retrieval window, in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format.
End Time End date/time for the data retrieval window, in YYYY-MM-DD or YYYY-MM-DD HH:MM:SS format.
Additional Options Collection of optional parameters:
- Averaging Interval (Minutes) Time averaging interval in minutes (0-60) used to calculate mean heart rate values. Defaults to 5 minutes.
- Ignore Metadata Boolean flag to return simplified response without FHIR metadata if set to true.
- Device Device type from which the measurement originated. Options: CardiacSense Watch, External Device, Manual by User. Default is CardiacSense Watch.
- AF Source Source for atrial fibrillation detection; options are ECG (default) or PPG. Only relevant for atrial fibrillation operations, not this one.

Output

The node outputs JSON data representing the averaged heart rate measurements over the specified time range and averaging interval. The structure typically includes:

  • Timestamped heart rate averages calculated over the defined intervals.
  • Optional metadata depending on the Ignore Metadata flag.
  • Device information indicating the source of the measurement.

If binary data were involved (not in this operation), it would represent raw measurement files or reports, but here output is purely JSON.

Dependencies

  • Requires an active connection to the Cardiacsense FHIR API.
  • Needs an API authentication token credential configured in n8n to authorize requests.
  • The node uses HTTP GET requests to fetch data from the Cardiacsense API endpoints.
  • No additional external libraries beyond those bundled with n8n are required.

Troubleshooting

  • Common Issues:

    • Invalid or missing patient email will cause the API request to fail.
    • Incorrect date/time formats for start or end times may result in errors or empty responses.
    • Using an unsupported device type or averaging interval outside 0-60 minutes may cause unexpected results.
    • Network connectivity issues or expired API tokens will prevent successful data retrieval.

  • Error Messages:

    • "Unknown operation: get8HourMean": Indicates the operation name was not recognized; ensure correct spelling and case.
    • "Unknown patient management operation": Occurs if the operation does not match expected values for patient management resources.
    • HTTP errors from the API (e.g., 401 Unauthorized) suggest invalid credentials or insufficient permissions.

  • Resolutions:

    • Verify all input parameters for correctness and completeness.
    • Confirm API credentials are valid and have necessary scopes.
    • Check network access and endpoint URLs.
    • Use the "Ignore Metadata" option to simplify responses if parsing issues occur.

Links and References

Discussion