DBL Integration

This is an easy way to integrate Discord Bot List voting with your bot.

Enable webhooks

Enabling vote hooking is very easy:

First open your KSoft.Si API dashboard (click here), then select your app and find this:

DBL Webhook settings

Then open your bot on Discord Bot List and click edit. Then find this:

In the URL field paste the "Your DBL webhook:" from the dashboard and in the Authorization paste the "Your authentication". So at the end it looks like this:

Complete settings

Click save, and you are done!

get
Check if user has voted

https://api.ksoft.si/webhook/dbl/check
Check if user has voted for your bot.
Request
Response
Headers
Authorization
required
string
Authentication token
Query Parameters
bot
required
integer
Your bot's Discord ID.
user
required
integer
Discord user ID that you are checking.
200: OK
If user has voted
{
"voted": true,
"data": {
"expiry": "2018-11-02T07:30:37.569592",
"extras": {
"reward": "004" //Query parameters passed to a voting site
},
"weekend": false
}
}
404: Not Found
If user has not voted
{
"voted": false
}

get
List of votes

https://api.ksoft.si/webhook/dbl/list
Get a list of the votes. This can be done once every 10 seconds.
Request
Response
Headers
Authorization
required
string
Authentication token
Query Parameters
bot
required
integer
Your bot's Discord ID.
200: OK
[
{
"expiry": "2018-11-02T07:30:37.569592",
"extras" {
"reward": "004"
},
"user": 175589848982355970,
"weekend": false
},
...
]
429: Too Many Requests
{
"details": "You can access this endpoint every 10 seconds."
}