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.
All participants in instantwin are registed in table INSTANTWINENTITY
Endpoint ID: | 2200 | |
Method: | GET | |
URL: | loyalty/instantwin/{apiID}/entity/id/{entityID} loyalty/instantwin/{apiID}/entity/ext-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 – participant won { "winner": ture, "details": { "id": "1", "name": "Some prize", "description": "This explains these prize", "numParticipants": 34, "numWinners": 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 |