Documentação da API

Bem-vindo à Documentação do Discord Extreme List

Versão da API	Estado	Por Padrão
v2	Disponível
v1 REVISADA	Descontinuado
v1	Descontinuado

Rotas que necessitam autorização estão identificadas com um ícone de cadeado.

GET Estatísticas do Sítio

https://api.discordextremelist.xyz/v2/stats

Resposta

	{
	"status": 200,
	"error": false,
	"servers": {
	"total": 71
	},
	"bots": {
	"total": 417,
	"approved": 344,
	"premium": 2
	},
	"users": {
	"total": 2092,
	"premium": 4,
	"staff": {
	"total": 10,
	"mods": 4,
	"assistants": 2,
	"admins": 4
	}
	},
	"templates": 10
	}

view raw api-response-stats.js hosted with ❤ by GitHub

GET Estado do Sítio

https://api.discordextremelist.xyz/v2/health

Resposta

	{
	"error": false,
	"status": 200,
	"redis_ok": true,
	"mongo_ok": true,
	"redis_ping": 0,
	"mongo_ping": 10
	}

view raw api-response-health.js hosted with ❤ by GitHub

GET Informação do Bot

https://api.discordextremelist.xyz/v2/bot/:id

Resposta

	{
	"error": false,
	"status": 200,
	"bot": {
	"id": "568254611354419211",
	"name": "Discord Extreme List",
	"prefix": "del,",
	"library": "Other",
	"tags": [
	"Fun",
	"Social",
	"Economy",
	"Utility",
	"Moderation",
	"Multipurpose",
	"Music",
	"Utility"
	],
	"vanityUrl": "",
	"serverCount": 0,
	"shardCount": 0,
	"flags": 0,
	"shortDesc": "Our amazing website bot!",
	"longDesc": "Mr. Delly Delicatessen",
	"editors": [
	"190916650143318016",
	"302604426781261824"
	],
	"owner": {
	"id": "1100295355800748073"
	},
	"avatar": {
	"hash": "5e897cca0996b6537fb4f97def3e3b35",
	"url": "https://cdn.discordapp.com/avatars/568254611354419211/5e897cca0996b6537fb4f97def3e3b35"
	},
	"links": {
	"invite": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
	"support": "https://discord.gg/WeCer3J",
	"website": "https://discordextremelist.xyz",
	"donation": "https://google.com",
	"repo": "https://gitlab.com/discordextremelist/del",
	"privacyPolicy": "https://discordextremelist.xyz/privacy"
	},
	"social": {
	"twitter": "ExtremeList"
	},
	"status": {
	"approved": true,
	"siteBot": true,
	"archived": false
	}
	}
	}

view raw api-response-bot.js hosted with ❤ by GitHub

POST Estatísticas do Bot

https://api.discordextremelist.xyz/v2/bot/:id/stats

Corpo de Requisição

	{
	"guildCount": 0
	"shardCount": 0 // Optional
	}

view raw api-body-bot-stats.js hosted with ❤ by GitHub

Resposta

	{
	"error": false,
	"status": 200,
	"guildCount": 0
	"shardCount": 0 // Won't always be returned
	}

view raw api-response-bot-stats.js hosted with ❤ by GitHub

GET Informação do Servidor

https://api.discordextremelist.xyz/v2/server/:id

Resposta

	{
	"error": false,
	"status": 200,
	"server": {
	"id": "568567800910839811",
	"name": "Delly",
	"shortDesc": "The official Discord server of Discord Extreme List: Discord's unbiased list, giving bots & servers a big chance!",
	"longDesc": "The official Discord server of Discord Extreme List: Discord's unbiased list, giving bots & servers a big chance!",
	"tags": [
	"Gaming",
	"Music",
	"Media & Entertainment",
	"Creative Arts",
	"Science & Tech",
	"Education",
	"Fashion & Beauty",
	"Relationships & Identity",
	"Travel & Food",
	"Fitness & Health",
	"Finance",
	"Science & Tech"
	],
	"previewChannel": "",
	"owner": {
	"id": "1100295355800748073"
	},
	"icon": {
	"hash": "a_ac9635250e1e351364f1bf3d67c3920b",
	"url": "https://cdn.discordapp.com/icons/568567800910839811/a_ac9635250e1e351364f1bf3d67c3920b"
	},
	"links": {
	"website": "https://discordextremelist.xyz",
	"donation": "https://www.patreon.com/discordextremelist"
	},
	"status": {
	"reviewRequired": false
	}
	}
	}

view raw api-response-server.js hosted with ❤ by GitHub

GET Informação do Modelo

https://api.discordextremelist.xyz/v2/template/:id

Resposta


	{
	"error": false,
	"status": 200,
	"template": {
	"id": "aUe6qZZgnhGh",
	"name": "Discord Extreme List",
	"region": "sydney",
	"locale": "en-US",
	"afkTimeout": 60,
	"verificationLevel": 2,
	"defaultMessageNotifications": 1,
	"explicitContent": 2,
	"roles": [
	{
	"name": "@everyone",
	"color": 0,
	"hoist": false,
	"position": 0,
	"permissions": 104189505,
	"managed": false,
	"mentionable": false
	}
	/* [...] Array of Discord roles - refer to Discord API documentation */
	],
	"channels": [
	{
	"type": 0,
	"position": 14,
	"name": "general",
	"nsfw": false,
	"topic": "The channel for general conversation!",
	"permissions_overwrites": null,
	"rate_limit_per_user": 0,
	"last_message_id": "",
	"bitrate": 64000,
	"last_pin_timestamp": null
	}
	/* [...] Array of Discord channels - refer to Discord API documentation */
	],
	"usageCount": 1,
	"shortDesc": "Such template by delicatessen ",
	"longDesc": "h e l p i v e f a l l e n a n d i c a n t g e t u p i n e e d @someone",
	"tags": [
	"Gaming",
	"Music",
	"Media & Entertainment",
	"Creative Arts",
	"Science & Tech",
	"Education",
	"Fashion & Beauty",
	"Relationships & Identity",
	"Travel & Food",
	"Fitness & Health",
	"Finance"
	],
	"fromGuild": "568567800910839811",
	"owner": {
	"id": "208105877838888960"
	},
	"icon": {
	"hash": "6d196d0d3df6daf0b919add69973dc60",
	"url": "https://cdn.discordapp.com/icons/568567800910839811/6d196d0d3df6daf0b919add69973dc60"
	},
	"links": {
	"template": "https://discord.new/aUe6qZZgnhGh"
	}
	}
	}

view raw api-response-template.js hosted with ❤ by GitHub

GET Informação do Utilizador

https://api.discordextremelist.xyz/v2/user/:id

Resposta

	{
	"error": false,
	"status": 200,
	"user": {
	"id": "1100295355800748073",
	"name": "carolina.slay",
	"discrim": "0",
	"fullUsername": "@carolina.slay",
	"flags": 128,
	"avatar": {
	"hash": "47ae315255d529fc701238413a2d015a",
	"url": "https://cdn.discordapp.com/avatars/1100295355800748073/47ae315255d529fc701238413a2d015a"
	},
	"profile": {
	"bio": "I am the founder of DEL, enjoy programming as a hobby and study an LLB and BA full time.",
	"links": {
	"website": "",
	"github": "carolinaisslaying",
	"gitlab": "",
	"twitter": "",
	"instagram": "",
	"snapchat": ""
	}
	},
	"game": {
	"snakes": {
	"maxScore": 37
	}
	},
	"rank": {
	"admin": true,
	"assistant": true,
	"mod": true,
	"tester": false,
	"translator": false,
	"covid": false
	}
	}
	}

view raw api-response-user.js hosted with ❤ by GitHub

Node.JS using Del.js

Crédito a @carolinaisslaying (View Del.js on npm) (View Gist)

npm i @discordextremelist/del.js --save

This example demonstrates how to post your server count to the DEL API:

	const Discord = require("discord.js");
	const client = new Discord.Client();
	const DEL = require("del.js");
	const del = new DEL.Del("API auth token", client.user.id);

	client.on("ready", () => {
	console.log(`Logged in as ${client.user.tag}.`);
	setInterval(() => {
	del.post(client.guilds.cache.size, 0) // You will probably need to change this.
	}, 600000); // 10 minutes in milliseconds
	});

	client.login("bot token");

view raw api-deljs-example.js hosted with ❤ by GitHub

The API wrapper also has functions for all other DEL API endpoints, for more information read the code on GitHub.

Del.py for Discord.py

Crédito a @moksej (View Del.py on PyPI) (View Gist)

pip install DEL.py

This example demonstrates how to post your server count to the DEL API:

	import delpy
	import logging

	from discord.ext import commands, tasks
	from logging.handlers import RotatingFileHandler

	logger = logging.getLogger('del.py')
	logger.setLevel(logging.DEBUG)
	handler = RotatingFileHandler(
	filename='path/to/prefered/log_dir/del.log',
	encoding='utf-8',
	mode='w',
	maxBytes=10 * 1024 * 1024, # 10 MB
	backupCount=5,
	delay=0
	)
	handler.setFormatter(logging.Formatter('%(asctime)s:%(levelname)s:%(name)s: %(message)s'))
	logger.addHandler(handler)

	class discordextremelist(commands.Cog):
	def __init__(self, bot):
	self.bot = bot
	self.update_stats.start()
	# you can get the bot's token from your bot's page on DEL
	self.delapi = delpy.Client(bot, "DELAPI_32chartoken-userid")
	self.delapi.start_loop(wait_for=1800) # wait_for argument is optional and defaults at 1800.

	def cog_unload(self):
	self.delapi.close_loop()

	def setup(bot):
	bot.add_cog(discordextremelist(bot))

view raw api-delpy-example.py hosted with ❤ by GitHub

The API wrapper also has functions for all other DEL API endpoints, for more information read the examples MD file on GitHub.

Node.js using node-fetch

Crédito a @carolinaisslaying (View Gist)

npm i node-fetch --save

	const fetch = require("node-fetch");

	const botID = client.user.id; // You will probably need to change this
	const URL = `https://api.discordextremelist.xyz/v2/bot/${botID}/stats`;

	const reqHeaders = {
	"Content-Type": "application/json",
	"Authorization": "TOKEN" // Put your DELAPI token here
	}

	const reqBody = {
	"guildCount": client.guilds.cache.size // You will probably need to change this
	}

	fetch(url, { method: "POST", headers: reqHeaders, body: JSON.stringify(reqBody)})
	.then((res) => {
	return res.json()
	})
	.then((json) => {
	console.log(json);
	});

view raw api-js-example.js hosted with ❤ by GitHub

Discord.py using aiohttp

Crédito a @duckmasteral (View Gist)

	import discord, aiohttp, json
	from discord.ext import tasks, commands

	class DEL(commands.Cog):
	def __init__(self, bot):
	self.bot = bot
	self.del_update_stats.start()

	def cog_unload(self):
	self.del_update_stats.cancel()

	@tasks.loop(minutes=30.0)
	async def del_update_stats(self):
	""" This automatically updates your server count to Discord Extreme List every 30 minutes. """
	await self.bot.wait_until_ready()
	async with aiohttp.ClientSession() as session:
	async with session.post(f'https://api.discordextremelist.xyz/v2/bot/{self.bot.user.id}/stats',
	headers={'Authorization': 'TOKEN', # Make sure you put your API Token Here
	"Content-Type": 'application/json'},
	data=json.dumps({'guildCount': len(self.bot.guilds)
	,'shardCount': len(self.bot.shard_id) # Remove this line if you don't have shards on your bot
	})) as r:
	js = await r.json()
	if js['error'] == True:
	print(f'Failed to post to discordextremelist.xyz\n{js}')

	def setup(bot):
	bot.add_cog(DEL(bot))

view raw api-discordpy-example.py hosted with ❤ by GitHub

A documentação oficial do Discord Extreme List

Bem-vindo à Documentação do Discord Extreme List

GET Estatísticas do Sítio

Resposta

GET Estado do Sítio

Resposta

GET Informação do Bot

Resposta

POST Estatísticas do Bot

Corpo de Requisição

Resposta

GET Informação do Servidor

Resposta

GET Informação do Modelo

Resposta

GET Informação do Utilizador

Resposta

Node.JS using Del.js

Crédito a @carolinaisslaying (View Del.js on npm) (View Gist)

Del.py for Discord.py

Crédito a @moksej (View Del.py on PyPI) (View Gist)

Node.js using node-fetch

Crédito a @carolinaisslaying (View Gist)

Discord.py using aiohttp

Crédito a @duckmasteral (View Gist)