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