Validate Token

From King Arthur's Gold Wiki
Jump to: navigation, search


Implementation Status: Implemented
URI: https://api.kag2d.com/player/$PLAYER/token/$TOKEN
HTTP Verbs Supported: GET
Response Type: JSON dictionary
HTTP Auth Required: No

Request Details

This resource is the validation of the token provided. Tokens are only allowed to be validated once, and they expire very shortly after they are created (subject to change, but assume on the order of 15-45 seconds). The response will be a boolean true if the token provided is valid (unused, unaltered, unexpired), false in all other cases. Currently the API returns HTTP 404 when a token has already been used or expired; please be sure to handle this or the playerTokenVerification key appropriately as this design is not 100% final yet.

Successful Response

{"playerTokenVerification": true}


This response may contain additional information in the future (such as player info and/or additional SSO response information if there is a SSO implementation in the future)

Error Conditions

No error conditions are known/documented right now, as they would likely just end up as a 'false' token validation.

See Also