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

권한 범위로 제한되는 4개의 엔드포인트.

모든 키는 부여한 권한 범위 안에서만 작동해요.

  • 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

참여가 저절로
돌아가게 할 준비가 됐나요?

멤버로 체험해 보기