This site and API are not maintained by Tappecue, please do not reach out to them with issues.
The Tappecue team was nice enough to share their API with me, and I wrote this front-end so others can interface with their Tappecue so they can extend the functionality.
Bug reports or issues should be directed to the Github for this project or email me.

POST /login Authenticate

This method performs the login and sends back an authentication token that is required to interact with the rest of the platform.

The session tokens are valid for 24 hours.

Please note: You will need to use your existing Tappecue login credentials.
This should be the username you log into the Tappecue app with - Not your email address

This API platform passes through the authentication details and generates a session token.

Sessions can only be started from the Tappecue mobile app

Request

Standard POST request { username: <Tappecue Username> password: <Tappecue Password> }

Example

curl -d "username=test&password=testpass" https://tappecue.babyvelociraptor.com/login

Response (JSON)

Sends back a json object containing an X-Auth-Token which needs to be included in all subsequent requests

{ "X-Auth-Token": "<UUID>" }

Notes

This site does not store your password.

I take a cryptographic hash of your password (sha256) and store it temporarily to allow for session durability across multiple logins while the existing session is still active.

GET /timezone Current Timezone

This method returns the user’s current timezone.

  • Default timezone is US/Eastern

Request

  • The header must include “X-Auth-Token: <Auth Token>”
Example

curl -H "X-Auth-Token: <token>" https://tappecue.babyvelociraptor.com/timezone

Response (JSON)

{ "timezone": "US/Eastern" }

POST /timezone Set Timezone

This method sets the user’s timezone.

Request

  • The header must include “X-Auth-Token: <Auth Token>”

Standard HTTP POST

{ "timezone": "US/Central" }

All Available/Supported Timezones are available from the /timezone/all call.

Example

curl -d "timezone=US/Central" -H "X-Auth-Token: <token>" https://tappecue.babyvelociraptor.com/timezone

Response (JSON)

Sends back the timezone as a JSON object for confirmation.

{ "success": true, "timezone": "US/Central" }

GET /timezone/all All Available Timezones

This method returns all currently supported timezones.

  • Default timezone is US/Eastern

Request

  • The header must include “X-Auth-Token: <Auth Token>”
Example

curl -H "X-Auth-Token: <token>" https://tappecue.babyvelociraptor.com/timezone/all

Response (JSON)

JSON list of currently supported timezones. [ "GMT", "UTC", "US/Alaska", "US/Arizona", "US/Central", "US/Eastern", "US/Hawaii", "US/Mountain", "US/Pacific" ]

GET /sessions Existing Sessions

This method returns a list of all current sessions associated with your Tappecue account.

Request

  • The header must include “X-Auth-Token: <Auth Token>”
Example

curl -H "X-Auth-Token: <token>" https://tappecue.babyvelociraptor.com/sessions

Response

JSON list of all current sessions

[ { "active": "1", "id": 1, "name": "test3", "start": "6/26/2017 3:21:22 PM", "tid": "57658" } ]

The ID field is used to pull temperatures

GET /session/:id Session Temperatures

This method returns a list of all available sensor temperatures for the given session.

Please note that due to caching this temperature will only update every 2 minutes.

Request

  • The header must include “X-Auth-Token: <Auth Token>”
Example

curl -H "X-Auth-Token: <token>" https://tappecue.babyvelociraptor.com/session/:id

Response

JSON object of current session’s temperature probe data (and other useful info)

{ "1": { "active": "0", "chamber": "0", "current_temp": "0 ", "last_update": "6/26/2017 3:25:36 PM", "max_temp": "0", "min_temp": "0", "name": " None", "wifi_disconnected": "0" }, "2": { "active": "0", "chamber": "0", "current_temp": "0 ", "last_update": "6/26/2017 3:25:36 PM", "max_temp": "0", "min_temp": "0", "name": " None", "wifi_disconnected": "0" }, "3": { "active": "1", "chamber": "1", "current_temp": "70 ", "last_update": "6/26/2017 3:25:36 PM", "max_temp": "275", "min_temp": "22", "name": "Ribs (chamber)", "wifi_disconnected": "0" }, "4": { "active": "0", "chamber": "0", "current_temp": "0 ", "last_update": "6/26/2017 3:25:36 PM", "max_temp": "0", "min_temp": "0", "name": " None", "wifi_disconnected": "0" } }

GET /session/:id/:probe_id Probe Temperature

This method returns a specific probe’s temperature from the session.

Please note that due to caching this temperature will only update every 2 minutes.

Request

  • The header must include “X-Auth-Token: <Auth Token>”

Example

curl -H "X-Auth-Token: <token>" https://tappecue.babyvelociraptor.com/session/:id/:probe_id

Response

JSON object of an individual probe temperature data from session (and other useful info)

{ "active": "1", "chamber": "1", "current_temp": "70 ", "last_update": "6/26/2017 3:25:36 PM", "max_temp": "275", "min_temp": "22", "name": "Ribs (chamber)", "wifi_disconnected": "0" }