API таблиц
Ваш собственный бот может попросить OFFlimits нарисовать таблицу результатов и получить в ответ картинку. Любая таблица, включая свои таблицы, бесплатна для каждого сервера.
Использование
Отправьте POST-запрос на https://api.offlimitsbot.com/api/board с заголовком Authorization: Bearer <ваш API-ключ>.
| поле | обязательно | описание |
|---|---|---|
server_id (или guild) | да | id сервера или сериализованный объект Guild из discord.js |
board_number | да | 1, 2 (текстовые), 3, 4, 6, 7, 8 или 5 / "custom" для своей таблицы сервера |
messages | нет | строки с результатами, например ["[TEAM A] 1 12", "[TEAM B] 2 5"] |
channel_id | если нет messages | канал, в названии которого есть results; OFFlimits читает его последние 70 сообщений |
board_id | нет | какую из своих таблиц сервера рисовать (её id из адреса в панели управления /custom-board/<id>); по умолчанию — таблица, выбранная через /setboard boards select |
board_name | нет | то же самое, но по названию таблицы (без учёта регистра) |
share_link | нет | то же самое, но по ссылке для обмена таблицей (/setboard share create) |
server_name | нет | название, которое выводится в шапке таблицы |
Используется собственная система очков сервера (заданная через /setpoints или в панели управления).
Результат
{ "image": "data:image/png;base64,iVBORw0KGgo..." }
Текстовые таблицы (1 и 2) возвращают { "content": "```...```" }; при ошибках возвращается { "error": "..." } с HTTP-кодом 422. Добавьте к адресу ?format=png, чтобы вместо JSON получить сам PNG-файл.
Примеры кода
JavaScript
const { AttachmentBuilder } = require("discord.js");
const response = await fetch("https://api.offlimitsbot.com/api/board?format=png", {
method: "POST",
headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
server_id: interaction.guild.id,
channel_id: resultsChannel.id, // или: messages: ["[TEAM A] 1 12", ...]
board_number: 3,
}),
});
if (!response.ok) throw new Error((await response.json()).error);
const attachment = new AttachmentBuilder(Buffer.from(await response.arrayBuffer()), {
name: "OFFlimits-board.png",
});
await interaction.editReply({ files: [attachment] });
Python
import aiohttp
async with aiohttp.ClientSession() as session:
async with session.post(
"https://api.offlimitsbot.com/api/board?format=png",
headers={"Authorization": f"Bearer {API_KEY}"},
json={"server_id": guild_id, "channel_id": channel_id, "board_number": 3},
) as resp:
png_bytes = await resp.read() # картинка таблицы
