All API calls are RESTful and require a unique, valid session token that is obtained during authentication and is not exposed in the URL.
All communication with APIs is encrypted via TLS/HTTPS. Data is transmitted to the web application as JSON streams over RESTful APIs.
About session tokens
New session tokens are generated upon login and invalidated on logout.
Session tokens are 1024 bits and expire after 8 hours or upon logout.
Session IDs are only included in the encrypted HTTPS header and are not exposed in the URL.
API Security
Every API endpoint verifies that:
there is a valid JWT access token
the access token is from a user who has permission/privilege to access the resource in question.
The access token is generated by Tidepool upon successful user authentication. It contains the user ID of the user as one of its claims, and it is signed with Tidepool’s private key using RS256 algorithm.
OAuth tokens are good for a max of 24 hours, and then will need to refresh the token if not handled state-fully by an application.