Discord 工具 · 每次调用 1 个额度

Discord 权限计算器

通过 API 将权限位字段转换为名称

通过一次 REST 调用，将 Discord 权限位字段转换为可读的权限名称，或将名称数组转回为合并的 64 位整数。无需位移，无需维护查找表。

位字段 ↔ 名称ADMINISTRATOR 标志完整 64 位集合边缘高速
Try the free demo View pricing
100 free credits No card required Global edge network Structured JSON

What it checks

位字段转名称

将任意权限整数解码为它所授予的确切权限标志。

名称转位字段

将权限名称数组合并为 Discord 所需要的单个整数。

ADMINISTRATOR 检测

即时标记无所不能的 ADMINISTRATOR 权限。

未知位报告

呈现任何不映射到已知权限的位。

Try it live

Live demo · 5 requests/min, no key needed
Click “Run review” to see the JSON response.

Quickstart

One authenticated POST request. Official JavaScript and Python SDKs available.

cURL
curl -X POST https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-permissions-calc \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"permissions":"274877990912"}'
JavaScript (fetch)
const res = await fetch(
  "https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-permissions-calc",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ permissions: "274877990912" }),
  },
);
const { result } = await res.json();
console.log(result.permission_names);
Python (requests)
import requests

r = requests.post(
    "https://api.mecanik.dev/v1/client/YOUR_UUID/tools/discord-permissions-calc",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={"permissions": "274877990912"},
)
print(r.json()["result"]["permission_names"])

Common use cases

机器人邀请链接

为 OAuth2 邀请 URL 计算确切的权限整数。

角色管理

在编辑角色时向管理员展示人类可读的权限。

仪表板

在机器人控制面板中呈现某个角色被授予的权限。

权限审计

通过解码角色的位字段来标记权限过高的角色。

Simple, pay-as-you-go pricing

Per call
1 credits
On signup
100 free
Packs from
$5
Credits
Never expire

Pay only for what you use, with no subscription. See full pricing.

何时使用 Discord 权限计算器 API

权限整数是构建 Discord 机器人时最容易出错的东西之一。一个位计算错误，就意味着你的机器人在生产中缺少 EMBED_LINKS，或者更糟，一个邀请链接给只需发送消息的机器人授予了 ADMINISTRATOR。手工进行位运算，或从论坛帖子里复制一个魔术数字，既无法扩展也难以审计。

Discord 权限计算器 API 消除了猜测：发送一个位字段，便得到它所授予权限的确切列表；或发送你想要的名称，便得到 Discord 所期望的单个整数。由于它是无状态的 REST 端点，可以干净地嵌入邀请链接构建器、角色管理仪表板，或在角色权限过高时失败的 CI 检查中。将它与 Discord API 套件搭配使用，即可用一个 API 密钥覆盖 intents、邀请和审核。

Frequently asked questions

什么是 Discord 权限位字段？

Discord 将角色或成员的权限存储为单个 64 位整数，其中每一位代表一项权限（例如 SEND_MESSAGES 或 BAN_MEMBERS）。这款 Discord 权限计算器在该整数与可读名称之间相互转换。

它能把权限名称转回整数吗？

可以。发送权限名称数组而非位字段，API 便会返回合并的整数，你可以将其放入机器人邀请 URL 或角色编辑中。

它涵盖每一项 Discord 权限吗？

是的。它涵盖完整的 64 位权限集合，单独标记 ADMINISTRATOR，并报告任何未知位，让你能够发现新增或已弃用的权限。

Discord 权限计算器 API 的费用是多少？

每次调用消耗 1 个额度。每个新账户均可获得 100 个免费额度，额度包起价 5 美元，无需订阅，且额度永不过期。

使用它需要我的机器人令牌吗？

不需要。此端点在本地执行计算，绝不联系 Discord，因此绝不会需要或传输你的机器人令牌。

Start building in under a minute

Create a free account and get 100 credits. No card required.

Get your API key