Difference between revisions of "Validate Token"

From King Arthur's Gold Wiki
Jump to: navigation, search
(Successful Response)
Line 3: Line 3:
  
 
'''Implementation Status:''' [[API_Implementation_Statuses#Implemented|Implemented]]<br/>
 
'''Implementation Status:''' [[API_Implementation_Statuses#Implemented|Implemented]]<br/>
'''URI:''' https://api.kag2d.com/player/$PLAYER/token/verification/$TOKEN<br/>
+
'''URI:''' https://api.kag2d.com/player/$PLAYER/token/$TOKEN<br/>
 
'''HTTP Verbs Supported:''' GET<br/>
 
'''HTTP Verbs Supported:''' GET<br/>
 
'''Response Type:''' JSON dictionary<br/>
 
'''Response Type:''' JSON dictionary<br/>

Revision as of 18:36, 3 September 2012


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.

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.