Voting API (1.0.2)

Download OpenAPI specification:

API for voting, coin/ticket management, and user/item/idol info.

admin

Add free tickets

Authorizations:

bearerAuth

Request Body schema: application/json
required

userId required	string
amount required	integer
txnId required	string
description required	string

Responses

Request samples

Payload

Content type

application/json

{"userId": "string",
"amount": 0,
"txnId": "string",
"description": "string"
}

Response samples

200

Content type

application/json

{"coins": 0,
"tickets": 0
}

Set exchange rates for items. Replace existing rates if rateId exists. Set rates to 0 to disable each exchange type.

Authorizations:

bearerAuth

Request Body schema: application/json
required

rateId required	string
inputBaht required	integer
outputCoins required	integer

Responses

Request samples

Payload

Content type

application/json

{"rateId": "string",
"inputBaht": 0,
"outputCoins": 0
}

Set exchange rates for items. Replace existing rates if rateId exists. Set rates to 0 to disable each exchange type.

Authorizations:

bearerAuth

Request Body schema: application/json
required

rateId required	string
itemId required	string
coinsPerItem required	integer
ticketsPerItem required	integer
votesPerItem required	integer

Responses

Request samples

Payload

Content type

application/json

{"rateId": "string",
"itemId": "string",
"coinsPerItem": 0,
"ticketsPerItem": 0,
"votesPerItem": 0
}

Set exchange rates for tickets. Replace existing rate if rateId exists. Set rate to 0 to disable.

Authorizations:

bearerAuth

Request Body schema: application/json
required

rateId required	string
ticketsPerCoin required	integer

Responses

Request samples

Payload

Content type

application/json

{"rateId": "string",
"ticketsPerCoin": 0
}

Get all exchange rates

Authorizations:

bearerAuth

Responses

Response samples

200

Content type

application/json

{"coins": [{"rateId": "string",
"inputBaht": 0,
"outputCoins": 0
}
],
"items": [{"rateId": "string",
"itemId": "string",
"coinsPerItem": 0,
"ticketsPerItem": 0,
"votesPerItem": 0
}
],
"tickets": [{"rateId": "string",
"ticketsPerCoin": 0
}
]
}

Get Idol items received by user.

Authorizations:

bearerAuth

query Parameters

idolId required	string Idol ID
page	integer Page number
perPage	integer Items per page
sortBy	string Enum: "asc" "desc" Sort by direction

Responses

Response samples

200

Content type

application/json

[{"amount": 0,
"itemId": "string",
"votes": 0
}
]

Get idol item transaction history by admin.

Authorizations:

bearerAuth

query Parameters

idolId required	string Idol ID
page	integer Page number
perPage	integer Items per page
sortBy	string Enum: "asc" "desc" Sort by direction

Responses

Response samples

200

Content type

application/json

[{"amountBurned": 0,
"amountEarned": 0,
"description": "string",
"idolId": "string",
"itemId": "string",
"rateId": "string",
"txnId": "string",
"txnTime": "2019-08-24T14:15:22Z",
"userId": "string",
"voteEarned": 0
}
]

Get idol votes by admin.

Authorizations:

bearerAuth

query Parameters

idolId

required

string

Idol ID

Responses

Response samples

200

Content type

application/json

0

0

user

Exchange coins for tickets

Authorizations:

bearerAuth

Request Body schema: application/json
required

rateId required	string
txnId required	string
amount required	integer Number of tickets to get

Responses

Request samples

Payload

Content type

application/json

{"rateId": "string",
"txnId": "string",
"amount": 0
}

Response samples

200

Content type

application/json

{"coins": 0,
"tickets": 0
}

Exchange coins for items

Authorizations:

bearerAuth

Request Body schema: application/json
required

rateId required	string
txnId required	string
idolId required	string
amount required	integer Number of tickets to get

Responses

Request samples

Payload

Content type

application/json

{"rateId": "string",
"txnId": "string",
"idolId": "string",
"amount": 0
}

Response samples

200

Content type

application/json

{"coins": 0,
"tickets": 0
}

Exchange tickets for items

Authorizations:

bearerAuth

Request Body schema: application/json
required

rateId required	string
txnId required	string
idolId required	string
amount required	integer Number of tickets to get

Responses

Request samples

Payload

Content type

application/json

{"rateId": "string",
"txnId": "string",
"idolId": "string",
"amount": 0
}

Response samples

200

Content type

application/json

{"coins": 0,
"tickets": 0
}

Add free tickets

Authorizations:

bearerAuth

Request Body schema: application/json
required

amount required	integer
txnId required	string
description required	string

Responses

Request samples

Payload

Content type

application/json

{"amount": 0,
"txnId": "string",
"description": "string"
}

Response samples

200

Content type

application/json

{"coins": 0,
"tickets": 0
}

Get user coin/ticket balance

Authorizations:

bearerAuth

Responses

Response samples

200

Content type

application/json

{"coins": 0,
"tickets": 0
}

Get user items balance

Authorizations:

bearerAuth

Responses

Response samples

200

Content type

application/json

[{"itemId": "string",
"amount": 0
}
]

Get user baht transaction history

Authorizations:

bearerAuth

query Parameters

page	integer Page number
perPage	integer Items per page
sortBy	string Enum: "asc" "desc" Sort by direction

Responses

Response samples

200

Content type

application/json

{"transactions": [{"txnId": "string",
"userId": "string",
"itemId": "string",
"rateId": "string",
"amountBurned": 0,
"amountEarned": 0,
"description": "string",
"txnTime": "2019-08-24T14:15:22Z"
}
]
}

Get user coin transaction history

Authorizations:

bearerAuth

query Parameters

page	integer Page number
perPage	integer Items per page
sortBy	string Enum: "asc" "desc" Sort by direction

Responses

Response samples

200

Content type

application/json

{"transactions": [{"txnId": "string",
"userId": "string",
"idolId": "string",
"itemId": "string",
"rateId": "string",
"amountBurned": 0,
"amountEarned": 0,
"voteEarned": 0,
"description": "string",
"txnTime": "2019-08-24T14:15:22Z"
}
]
}

Get user ticket transaction history

Authorizations:

bearerAuth

query Parameters

page	integer Page number
perPage	integer Items per page
sortBy	string Enum: "asc" "desc" Sort by direction

Responses

Response samples

200

Content type

application/json

{"transactions": [{"txnId": "string",
"userId": "string",
"idolId": "string",
"itemId": "string",
"rateId": "string",
"amountBurned": 0,
"amountEarned": 0,
"voteEarned": 0,
"description": "string",
"txnTime": "2019-08-24T14:15:22Z"
}
]
}

Get Idol items received by user.

Authorizations:

bearerAuth

query Parameters

idolId required	string Idol ID
page	integer Page number
perPage	integer Items per page
sortBy	string Enum: "asc" "desc" Sort by direction

Responses

Response samples

200

Content type

application/json

[{"amount": 0,
"itemId": "string",
"votes": 0
}
]

Get idol item transaction history by user.

Authorizations:

bearerAuth

query Parameters

idolId required	string Idol ID
page	integer Page number
perPage	integer Items per page
sortBy	string Enum: "asc" "desc" Sort by direction

Responses

Response samples

200

Content type

application/json

[{"amountBurned": 0,
"amountEarned": 0,
"description": "string",
"idolId": "string",
"itemId": "string",
"rateId": "string",
"txnId": "string",
"txnTime": "2019-08-24T14:15:22Z",
"userId": "string",
"voteEarned": 0
}
]

Get idol votes by user.

Authorizations:

bearerAuth

query Parameters

idolId

required

string

Idol ID

Responses

Response samples

200

Content type

application/json

0

0

Get transaction detail

Authorizations:

bearerAuth

path Parameters

txnId

required

string

Transaction ID

Responses

Response samples

200

Content type

application/json

[{"amountBurned": 0,
"amountEarned": 0,
"description": "string",
"itemId": "string",
"rateId": "string",
"txnId": "string",
"txnTime": "2019-08-24T14:15:22Z",
"userId": "string"
}
]

webhook

Omise webhook handler

Send [userId, rateId, txnId, description, fullname, taxPayerNumber, email, address, status, failureMessage] into metadata of Omise Charge (JWT Signed with JWT_SECRET)

Authorizations:

bearerAuth

Voting API (1.0.2)

admin

Add free tickets

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Set exchange rates for items. Replace existing rates if rateId exists. Set rates to 0 to disable each exchange type.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Set exchange rates for items. Replace existing rates if rateId exists. Set rates to 0 to disable each exchange type.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Set exchange rates for tickets. Replace existing rate if rateId exists. Set rate to 0 to disable.

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Get all exchange rates

Authorizations:

Responses

Response samples

Get Idol items received by user.

Authorizations:

query Parameters

Responses

Response samples

Get idol item transaction history by admin.

Authorizations:

query Parameters

Responses

Response samples

Get idol votes by admin.

Authorizations:

query Parameters

Responses

Response samples

user

Exchange coins for tickets

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Exchange coins for items

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Exchange tickets for items

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Add free tickets

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get user coin/ticket balance

Authorizations:

Responses

Response samples

Get user items balance

Authorizations:

Responses

Response samples

Get user baht transaction history

Authorizations:

query Parameters

Responses

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required