Games and Awards
From ePrize Developers Wiki
| Line 1: | Line 1: | ||
| + | __NOTOC__ | ||
{{Logo}} | {{Logo}} | ||
[[API Home Page]] | [[API Home Page]] | ||
| Line 23: | Line 24: | ||
</div> | </div> | ||
| - | + | == Games Overview == | |
| + | |||
| + | There are two types of games that can be played with ePrize Web Service, Instant Win and Sweepstakes games. These will be configured into your [[API Key]]. Your key may have only one type of game, both, or neither. If there are multiple games, each must be played separately, based on the desired behavior. | ||
| + | |||
| + | === Instant Win Games === | ||
| + | |||
| + | An instant win game is a game where the user can be notified immediately if they are a winner or not. Instant win games require a valid token to play. [[Redeem_token|Tokens]] can only be awarded within the limits associated with your [[API Key]]. | ||
| + | |||
| + | === Sweepstakes Games === | ||
| + | |||
| + | A sweepstakes game collects [[Award_sweepstakes_entry|entries]] from users throughout the duration of the game. These can be awarded for various actions such as a login or registrations. A winner will be selected at the end of the game. | ||
| + | |||
| + | == Prizes == | ||
| + | |||
| + | Games are holders of prizes. The prizes to be awarded will be configured when the [[API Key]] is created. | ||
| + | |||
| + | == Limits == | ||
| + | |||
| + | Each game and prize will have limits associated with it during the creation of the [[API Key]]. For example, in a sweepstakes a limit would be that 1 entry could be awarded per day. | ||
Revision as of 18:34, 7 April 2011
| Award sweepstakes entry | POST /v1/{apikey}/game/{game}/sweeps |
| Award instant win token | POST /v1/{apikey}/game/{game}/tokens |
| Fetch token | GET /v1/{apikey}/game/{game}/token/{token} |
| Redeem token | POST /v1/{apikey}/game/{game}/token/{token} |
| Fetch prize | GET /v1/{apikey}/game/{game}/prize/{prize} |
Games Overview
There are two types of games that can be played with ePrize Web Service, Instant Win and Sweepstakes games. These will be configured into your API Key. Your key may have only one type of game, both, or neither. If there are multiple games, each must be played separately, based on the desired behavior.
Instant Win Games
An instant win game is a game where the user can be notified immediately if they are a winner or not. Instant win games require a valid token to play. Tokens can only be awarded within the limits associated with your API Key.
Sweepstakes Games
A sweepstakes game collects entries from users throughout the duration of the game. These can be awarded for various actions such as a login or registrations. A winner will be selected at the end of the game.
Prizes
Games are holders of prizes. The prizes to be awarded will be configured when the API Key is created.
Limits
Each game and prize will have limits associated with it during the creation of the API Key. For example, in a sweepstakes a limit would be that 1 entry could be awarded per day.
