Welcome

Welcome to the Official Sentcord Docs, here you will be able to find any thing related to our api!

Introduction

These developer pages document how to use our API to help you create and grow awesome bots for your community!

Getting Help

If you need help with our API please join our Discord server at https://sentcord.com/discord and ask in the API channel.

Reference

Our API is a HTTPS/REST for general operations such as sending POST requests and receiving GET requests

Base URL

https://sentcord.com/api

Authentication

To access our API you need to authorize yourself, this can be done by using your discord bot list token. Your token can be obtained from the @me page.

Authentication is performed with the Authorization HTTP header in the format Authorization: TOKEN

Example Authorization Header

Authorization: 4xp1a3Q2FyrDm470rTU5xFMgfhDtdunz

Resources

post
Stats

https://sentcord.com/api/bot/:id
This endpoint allows you to post your Stats
Request
Response
Request
Path Parameters
id
required
string
The ID of the bot you are requesting to update.
Headers
Authentication
required
string
Sentcord API Token
Query Parameters
shardCount
optional
string
The bot's shard count
ServerCount
required
string
The bot's guild count
Response
200: OK
{
success: true,
msg: 'Stats have been posted.',
data: { time: 1604828952.876, servers: 1791, shards: 2 }
}
400: Bad Request
{
success: false,
msg: "Can be what ever is wrong"
}

NodeJS Example

let
fetch = require('node-fetch'),
botid = client.user.id, // Required
serverCount = client.guilds.size, // Required
shardCount = client.shards.size, // Optional
apiKey = "YourKeyHere", // Required
url = `WILL BE RELEASED LATER`;
fetch(url, {
method: "POST",
headers: {
"Authorization": key,
"Content-Type": "application/json"
}
body: JSON.stringify({ serverCount: serverCount, shardCount: shardCount })
}).then(r => r.json()).then(d => console.log(d)).catch(e => console.log(e.stack));

get
Bot Information

https://sentcord.com/api/bot/:id
Request
Response
Request
Path Parameters
id
required
string
Response
200: OK
{
success: true,
msg: "we got da data! :D"
data: {
stats: {
time: 1604828949.556,
servers: 0,
shards: 0
},
stats: verified,
owners: [
0: "ID1",
1: "ID2",
2: "ID3"
],
prefix: "??"
username: "ExampleAPIBot",
botid: "693846748824884174140",
logo: "https://cdn.discordapp.com/avatars/BOTID/AVATAR.png?size=1024",
invite: "https://bot_invite.org",
website: "https://bot_website.org", // Certified Bots only
github: "https://github.com/UR_NAME/UR_BOT",
privacy: "https://yourprivacypolicylink.org",
description: {
short: "bot info small",
long: "very long info..."
}
dates: {
added: 1604828949.556,
listed: 1604828949.556,
certified: 1604828949.556,
}
}
}
404: Not Found
{
success: false,
msg: "failed to find the bot :/"
}