Cal Hacks SDK Challenge

SDK Template

Api Server Template

Quickstart

1. Integrate the SDK on your Android application.

2. Start walking with the phone in your pants pocket!

  • ~5 min of walking data
  • 1 unique user per device

3. Query authentication scores from devices on your server.

4. Profit! Prize for most creative integration of the API.

How to query the server for user scores

GET /v1/api/score/user/<user-identifier>
Returns an aggregate score of the user’s authentication state based on all of his/her devices.

Example response (Content-type: application/json):
{
  "score": 0.99453,
  "confidence": 0.87624,
  "decision": true,
  "timestamp": 1493596800
}

Parameters
user-identifier: The user identifier that was passed into the register() call in the device SDK.

Response fields
score: A floating point number between 0.0 and 1.0 that represents the approximate probability the user has possession of his/her devices. A higher number is more likely to be the user.
confidence: A floating point number between 0.0 and 1.0 that represents the confidence level in the score. Higher numbers represent higher levels of confidence.
decision: The final boolean decision, combining both the score and the confidence. True means that we predict it is the user with high confidence, and false otherwise.
timestamp: The UNIX timestamp (seconds since epoch) of the last data sample received for that user, for informational purposes.

Response Codes
200: Valid request, user found, and data returned correctly.
404: User not found, or user does not have any registered devices.
401: Request was not authenticated.
400: Malformed request.

Stuck? Find us!

Join us on Slack