QC Rounds

From Triangle Wiki

Jump to: navigation, search

Contents

Rounds Overview

The calls in this section revolve around the Flash games retrieving a valid Round and Game number.

To summarise:

  • Each Round may contain multiple games.
  • Round Number will start at 0
  • Each Game within each new Round will start at 0
  • Each request will be Logged into the Database - with the given Round Number or Game Number and the time of insertion as a Unix Timestamp.
  • Only the Start call will increment the number, the Stop calls are simply parse through logging.

Global Arguments Required

  • api_key: Your API application key.

Call - startround

URL

Arguments Required

  • gameID: The Identifying number that represents the game being played - i.e. Conundrum

Example Response

  1. <sites_Facebook_Springdoo_quizchannel_classes_ApiClass generator="zend" version="1.0">
  2. <startRound>
  3. <roundNumber>101</roundNumber>
  4. <status>Success</status>
  5. </startRound>
  6. </sites_Facebook_Springdoo_quizchannel_classes_ApiClass>

Call - stopround

URL

Arguments Required

  • roundNumber: The Identifying number that represents the Round being played

Example Response

  1. <sites_Facebook_Springdoo_quizchannel_classes_ApiClass generator="zend" version="1.0">
  2. <stoproundService>
  3. <status>Success</status>
  4. </stoproundService>
  5. </sites_Facebook_Springdoo_quizchannel_classes_ApiClass>

Call - startgame

URL

Arguments Required

  • roundNumber: The Identifying number that represents the Round being played

Example Response

  1. <sites_Facebook_Springdoo_quizchannel_classes_ApiClass generator="zend" version="1.0">
  2. <startGame>
  3. <gameNumber>101</gameNumber>
  4. <status>Success</status>
  5. </startGame>
  6. </sites_Facebook_Springdoo_quizchannel_classes_ApiClass>

Call - stopgame

URL

Arguments Required

  • gameNumber: The Identifying number that represents the Game being played

Example Response

  1. <sites_Facebook_Springdoo_quizchannel_classes_ApiClass generator="zend" version="1.0">
  2. <stopGame>
  3. <status>Success</status>
  4. </stopGame>
  5. </sites_Facebook_Springdoo_quizchannel_classes_ApiClass>

Error Codes

  • 100: Invalid API Key: Value is empty, but a non-empty value is required.
  • 105: Service currently unavailable: The requested service is temporarily unavailable.
  • 111: Format "xxx" not found: The requested response format was not found.
  • 112: Method "xxx" not found: The requested method was not found.

External Links

Personal tools