GameCenter Web Api

<back to all web services

Authenticate

Get an authentication token.

Make sure this is only called over an encrypted (SSL) tunnel!

Requires a Username (usually an email address) and a DeviceToken (preferred; get one from AuthorizeDevice) or a Password (deprecated).

The returned AuthToken that should be sent with all follow up requests to this API that require authentication.

This AuthToken will expire, and a new token will need to be retrieved via this endpoint again.

The following routes are available for this service:
POST/authenticate
Parameters:
NameParameterData TypeRequiredDescription
UsernamebodystringYesUsername, usually an email address
DeviceTokenbodystringNorequired, but mutually exclusive with Password; unencrypted—but make sure the tunnel is encrypted with SSL before sending!
PasswordbodystringNorequired, but mutually exclusive with DeviceToken; unencrypted—but make sure the tunnel is encrypted with SSL before sending!

To override the Content-type in your clients HTTP Accept Header, append the .other suffix or ?format=other

HTTP + OTHER

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /stat/reply/Authenticate HTTP/1.1 
Host: api.digitalscout.com 
Content-Type: application/stat
Content-Length: length