Pulsoid is real-time heart rate streaming platform. Pulsoid can obtain heart rate data from Apple Watch, WearOS watches, IOS and Android phones. The goal of Pulsoid API is to hide the complexity of obtaining heart rate and to provide simple, fast, secure and reliable way to transfer this data to 3rd-party developers and applications.
The core of Pulsoid Read API is a WebSocket connection. WebSocket is a computer communications protocol that provides communication channels over a single TCP connection. WebSocket implementation improves delivery time of the heart rate data and makes it almost instantaneous.
Obtaining a user access token is the first step of using Pulsoid as a platform.
How to obtain a user access token?
There are 6 different ways to obtain user’s access token, optimized for each specific use case:
If you are developing for yourself, then Manual Token Issuing is suitable for you and client credentials are not needed
If you have a website, then Implicit Grant is suitable for you
If you are developing a desktop application that is able to handle deep links, then Implicit Grant is suitable for you
If you have a backend server, then Authorization Code Grant is suitable for you
If you are developing a plugin or desktop application, then Implicit Grant with response_type=web_page is suitable for you
If you are developing an enterprise application and want to use Pulsoid as a platform for obtaining real-time heart rate from your customers, contact us at firstname.lastname@example.org or Discord. Also, you can read the guide to check our capabilities
If you have any questions, ask us on Discord
More info about obtaining tokens can be found in Pulsoid API documentation.
1. Install pulsoid/socket npm package
2. Initialize PulsoidSocket object
3. Subscribe to the heart rate. Heart rate message contains two fields
measuredAt - a unix timestamp in millis of when heart rate was meassured on user’s device. Note: there are cases when user’s device time can differ from the real one for 30+ seconds.
heartRate - heart rate in beats per minute
Complete documentation is available on our github.
WebSocket is a stateful protocol so graceful handling of reconnects is important. It helps ensure that the client can continue to communicate with the server without interruption, even if there are temporary network issues or other problems that cause the connection to be lost. This is especially important for Pulsoid, where real-time communication is critical. Also, opened WebSocket connection doesn’t mean that there is heart rate data.
To address these points, we created two layers of events:
Connected/Disconnected/Reconnecting events describe state of WebSocket connection itself. In most cases Disconnected/Reconnected events appear due to network problems or Pulsoid servers rebalancing. These are rare events but at the same time, they must be handled properly to achieve best user experience. By default, PulsoidWebsocket does graceful reconnect under the hood. Default reconnection strategy is pretty aggressive - up to 24 hours for Pulsoid to become live. Also, you can customize reconnection strategy using these parameters.
Online/Offline events describe the state of heart rate streaming. Online event is emitted for the first received heart rate event. Offline event is emitted in case where there was no heart rate data input for 30 seconds. Therefore, these events can be used to communicate to the user that there is no heart rate data.
To learn more about events check out our documentation for pulsoid/socket.