Register a participant in instant win
There are 2 tables where we define a instant win competition.
- INSTANTWIN - defines an competition. Field PUBLICID (guid) is a public reference to a competition. Field MAXNOOFTRYPERENTITY define how meny times same person can perticipate in the same competition. Field MAXNOOFGAINSPERENTITY define how many gains same person can win in a competition.
- Table INSTANTWINGAIN define gains for a competition. There can be more then 1 gain per competition. Field INSTANTWINID connect gain table to instanwin table. Fields MAXNOOFGAINS defines maximal number of gains to win. Field DRAWFREQUENCY defines how offen there is a winner.
| Endpoint ID: | 2200 | |
| Method: | GET | |
| URL: | loyalty/instantwin/{apiID}/id/{entityID} loyalty/instantwin/{apiID}/iext-key/{ext-key}/{ext-type} | |
| apiID | A GUID string identifier for the instant win | |
| entityID | dialogportal™ master key that uniquely identifies the entity | |
| ext-key | External key that uniquely identifies the entity | |
| ext-type | Type of external key | |
| Request body: | None | |
Response body: | JSON data with information about winner status loyalty/instantwin – participient won {
"winner": ture,
"details": {
"id": "1",
"name": "Some gain",
"description": "This explains these gain",
"noofparticipients": 34,
"noofwinners": 3
}
]
}
loyalty/instantwin – participient lost {
"winner": false,
"details": ""
]
}
| |
| Status codes: | 200 | OK |
| 404.1 | Instant win not found | |
| 404.2 | Instant win gain not found | |
| 500.3 | Server erreor | |