|
|
|
Authentication Web Service
Web Service URL:
http://api.interactrivia.com/ws/Authentication.asmx
Web Service WSDL:
http://api.interactrivia.com/ws/Authentication.asmx?wsdl
Overview
The Authentication service is used to retrieve a valid Authentication Token for
subsequent Partner service requests. All calls to the Authentication service
must be made using SSL encryption or "https".
Methods
The Authentication service has only one method, Authenticate, and requires two string
parameters: PartnerID (username) and PartnerKey (password).
Return Values
Calls to the Authenticate method return an AuthenticationResult object with three
properties: Status, Message and Result.
Status is a string value and can be any of the following:
- HTTPS_REQUIRED - calls must be made over an SSL connection (use
"https://").
- AUTH_FAILURE - authentication failed. Try again.
- AUTH_SUCCESS - authentication succeeded, use Result property
as token for subsequent calls.
- ERROR - there was an error processing authentication, see Message
property for more information.
Authentication Tokens
Authentication Tokens are valid for 10-minutes and expire on a sliding scale. Each
subsequent request to the Partner service using your token extends its expiration.
Notes
None.
|
|