QuickStart Guide
Description
Discover the comprehensive ROOK guide to seamlessly integrating and analyzing health data. Learn how to utilize ROOK APIs and SDKs to collect data, configure webhooks for real-time notifications, and ensure a smooth production deployment.
Prerequisites
Team Requirements for ROOK Integration
To successfully integrate ROOK, your organization needs the following teams based on your APP needs:
Backend Team
- Receive Data: Build an API on your end to receive health data sent by ROOK.
- Data Storage and Processing: Store the data securely on your servers for further processing.
- Serve Your APP: Develop an API to serve your end-user APP.
Frontend Team (Optional)
- Custom Connections Pages: Create a user-facing page that allows users to authorize access to their health data.
- Dashboards: Build user-friendly dashboards or interfaces to present health data to end users in a clear and actionable format.
Mobile Team (If Needed)
ROOK integrates with two types of data sources: API-Based and Mobile-Based. Learn more about supported sources in Data Sources.
- If Interested in Mobile-Based Data Sources:
- Use the ROOK Extraction APP: This ready-to-use APP collects data from Apple Health and Health Connect, requiring no mobile development but offering neutral branding.
- Develop a Custom Mobile APP: If the client has an existing APP or wishes to create one with personalized branding and features, a mobile team is needed to integrate ROOK SDKs for Apple Health and Health Connect data collection.
Data Sources and Testing
Once you have identified the data sources that align with your project goals (for example, Fitbit, Garmin, Apple Health), it is recommended to:
- Obtain Devices or Accounts for the target data sources to test and validate the integration process.
- Ensure Test Users Have Existing Data: Having a few users with wearables from your selected data sources can greatly aid testing. Ideally, these users should have some days of health data already logged.
ROOK supports the extraction of pre-existing data from connected sources. For more details, see Data Sources.
Recommended Architecture for ROOK Clients
To successfully integrate ROOK into your solution, you need to establish a basic architecture that supports receiving, storing, and serving health data. Here is a high-level overview:
Data Reception:
- Create an endpoint (such as a webhook URL) in your backend to receive data from ROOK.
- ROOK delivers data primarily via webhooks for real-time updates or daily summaries.
Data Storage:
- Store the data received from ROOK in your system or cloud infrastructure. This ensures you can manage, process, and analyze the data as needed for your business use case.
Backend Development:
- Your backend must:
- Receive and store the data from ROOK.
- Process the data as needed.
- Serve the data to your end-user applications (web or mobile).
- Your backend must:
Frontend or APP Integration:
- If you have a mobile APP:
- Integrate ROOK SDKs to extract data from mobile-based sources (for example, Apple Health, Health Connect).
- Alternatively, use the ROOK Extraction APP, a ready-to-use solution for mobile-based data sources.
- If you have a web APP:
- Your backend should serve the stored data to the web APP, allowing you to display health metrics or provide actionable insights.
- To connect users to health data sources, build your connections web page or APP view using ROOK APIs.
- If you have a mobile APP:
Integration Steps
The integration process is divided into sandbox testing and production implementation.
Overview
- Create an Account on the ROOK Portal.
- Test in Sandbox Environment:
- Generate credentials.
- Configure data sources.
- Set up webhooks.
- Connect users.
- Validate data flow.
- Transition to Production:
- Request production enablement.
- Configure production environment.
- Connect users.
- Start receiving live data.
Step 1: Create Your Account
The ROOK Portal is your central hub for integration. Once registered, you can:
- Generate credentials for sandbox and production environments.
- Configure data sources, webhooks, and endpoints.
- Monitor integration performance.
Required Information
- email and password
- Company name, sector, and optional logo
- Project lead's name and role
- Estimated number of users
Conclusion
ROOK's QuickStart Guide provides the foundation for seamless integration:
- Create an Account on the ROOK Portal.
- Test in Sandbox to validate workflows.
- Transition to Production for live data delivery.
For further details and advanced features, explore: