Skip to content
This repository was archived by the owner on Jan 1, 2024. It is now read-only.

Upgrading from Pulsoid to PulsoidSocket

200Tigersbloxed edited this page May 6, 2022 · 1 revision

Preface

Pulsoid is a great provider for HeartRate data, offering numerous HeartRate trackers for easy use. Earlier this year, Pulsoid had made the decision to deprecate their Feed Url, a main way of easily grabbing data. Since then, we've had to engineer our own solution while we looked for newer ways to adapt to Pulsoid's official data. Thanks to their amazing team, they were able to finally release their Implicit Grant, making it simple for any application to grab HeartRate data from their servers!

Why you should Upgrade

While we did our best to ensure that grabbing HeartRate data from our servers could not be exploited, mainly by privatizing all source-code to prevent users from abusing the system, it isn't perfect, nor could it be because of how isolated we are from Pulsoid's internals (obviously). We can't tell if a client inputting a WidgetId is the owner of that, we don't have to resources to be able to do that, so that's what the switch is for.

Switching will ensure greatest account security, preventing any outside sources from being able to access your HeartRate data by protecting it behind an internal access token that only your account can generate.

On top of this, we will be deprecating our Pulsoid services in the near future (~1 month - 2 months) and will be removing all documentation on using a Pulsoid WidgetId to grab data. All future users requesting support for WidgetId will be turned down and be told to upgrade, and be sent here!

Upgrading

This portion of the guide assumes you use the UI Helper, however, all steps will be convert-able to the Console application.

Setting the hrType

Navigate to your Config tab and select hrType, then enter in pulsoidsocket.

image

Retrieving a PulsoidKey (access_token)

Navigate here or optionally here if you have a BRO subscription. Once on the webpage, select Authorize app, then you will be redirected to a page with a textbox containing your key.

hbtgjhgbjf


🛑 DO NOT SHARE YOUR ACCESS TOKEN! 🛑

Access Tokens allow users to retrieve your HeartRate Data


You will copy that key, and be sure to save it, because we will need it for the next step.

Applying your PulsoidKey (access_token)

Back in your Config tab, select the pulsoidkey, and then enter in the access_token you got from the previous step.

image

Final Steps

That's it, just Start the app and you're now using PulsoidSockets!