GameCenter Web Api

<back to all web services

LatestAppVersion

Returns the details and link to the latest version of the requested app.

Checking against the VersionCode numerically (better), or the Version string equality (if you must), are probably the simplest comparison methods to determine if the user should be shown or redirected to the appropriate upgrade messages and links.

Sends and respects incoming HTTP caching headers, which are recommended for use by the client as well.

The HtmlMessage and TextMessage should be the same—show only the appropriate one for your UI.

The following routes are available for this service:
GET/versions/{PackageName}/{Platform}/{VersionCode}/{Version}
Parameters:
NameParameterData TypeRequiredDescription
PlatformpathstringYesmust be "iOS" or "Android"
PackageNamepathstringYespackage name unique to each platform's store; so far, must be one of: "com.gamecenter.football", "com.gamecenter.basketball", "ds-basketball-statware", "ds-football-statware", "ds-volleyball-statware"
VersionCodepathstringYesInteger version code; ie. 123, 124, 125, ...
VersionpathstringYesSemantic version; ie. 1.0.23, 2.1.0, 2.1.1-beta, ...

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

HTTP + CSV

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

POST /csv/reply/LatestAppVersion HTTP/1.1 
Host: api.digitalscout.com 
Content-Type: text/csv
Content-Length: length

Platform,PackageName,VersionCode,Version
String,String,0,String

HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

Platform,VersionCode,Version,PackageName,FriendlyName,Sport,TextMessage,HtmlMessage,LinkUrl
String,0,String,String,String,Football,String,String,String