Engagerly 2.0 · 讓 Discord 營運回到一條清晰的工作流程
開發者 API

把 Engagerly 串接你自己的系統

在你的應用、遊戲和店鋪裡讀取和調整成員餘額、新增或移除身分組——API 金鑰按權限範圍授權，每次呼叫都有完整的操作日誌。

查看 API 文件

Premium+Premium 和 Ultimate 可在控制台建立 API 金鑰

REQUEST成員下單時，為其增加 500 積分。

curl -X POST "$API_BASE/v2/open/guilds/$GUILD_ID/points/adjust" \
  -H "X-API-Key: $ENGAGERLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123456789012345678",
    "type": "add",
    "amount": 500,
    "note": "Order #1042 bonus",
    "ref": "order-1042"
  }'
USE CASES

團隊用它做什麼

  • 遊戲內獎勵

    玩家在你的遊戲裡達成成就時發放積分。

  • 下單獎勵

    顧客下單後，獎勵積分或 VIP 身分組。

  • 活動簽到

    給參加直播活動或網路研討會的每個人發放身分組。

ENDPOINTS

四個端點，按權限範圍授權。

每個金鑰只能使用你授予它的權限範圍。

  • GET
    /v2/open/guilds/{guild_id}/points/balance/{user_id}

    查詢成員在伺服器任一貨幣中的餘額。

    points:read
  • POST
    /v2/open/guilds/{guild_id}/points/adjust

    為成員增加或扣除積分，可附帶備註和你自己的參考 ID。

    points:write
  • POST
    /v2/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    給成員新增一個 Discord 身分組。

    roles:write
  • DELETE
    /v2/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    移除成員的一個 Discord 身分組。

    roles:write
KEYS & LIMITS

金鑰與限制

  • Premium 或 Ultimate 可在控制台建立 API 金鑰，每個伺服器最多 10 個。
  • 在 X-API-Key 請求標頭中傳送金鑰。每個金鑰只對自己所屬的伺服器有效。
  • 只授予金鑰需要的權限範圍：points:read、points:write 或 roles:write。
  • 可以為每個金鑰設定到期日期和 IP 白名單。
  • 每把金鑰每分鐘可讀 120 次、寫 60 次，每個伺服器每分鐘合計 200 次；每次呼叫都會紀錄在此金鑰的操作日誌中。

想知道 API 接下來會有什麼？

新端點會先在官方 Discord 伺服器裡徵求意見。

加入官方 Discord 伺服器
READY WHEN YOU ARE

準備好讓參與
自己轉起來了嗎？

以成員身分體驗