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

Discord 权限计算器

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

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

位字段 ↔ 名称 ADMINISTRATOR 标志 完整 64 位集合 边缘高速
100 free credits No card required Global edge network Structured JSON
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"}' 
01

What it checks

位字段转名称

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

名称转位字段

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

ADMINISTRATOR 检测

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

未知位报告

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

02

在线试用

在线演示:每分钟5次请求,无需密钥
点击运行以查看JSON响应。
03

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"])
04

Common use cases

机器人邀请链接

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

角色管理

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

仪表板

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

权限审计

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

05

Simple, pay-as-you-go pricing

每次调用
1 积分
注册时
100 免费
套餐起价
$5
积分
永不过期

按使用量付费,无需订阅。 查看完整价格.

何时使用 Discord 权限计算器 API

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

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

06

常见问题

什么是 Discord 权限位字段?

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

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

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

它涵盖每一项 Discord 权限吗?

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

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

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

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

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

07

Start building in under a minute

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

Get your API key

项目始于一次沟通

告诉我们
您的想法。

分享所需的成果、现有系统和限制条件。开始时无需准备技术规格书。

如果表单无法使用,请直接发送邮件给我们: contact@mecanik.dev

直接工程支持

直接进行技术协作。
明确的范围,负责任的交付。