Noxyr는 이제 무료로 서버별 REST API를 제공합니다. 실시간 Discord 데이터, 즉 멤버 수, 티켓 분석, 활동 지표, 매출, 리뷰, 경품 추첨 정보를 내 웹사이트, 대시보드, 모바일 앱, 또는 다른 봇으로 가져올 수 있습니다. 서버마다 키 하나를 대시보드에서 만들고, SHA-256 해싱으로 보호되며, 내가 켜고 끌 수 있는 범위(scope) 토글로 접근이 제어됩니다.
서버 단위 API가 필요한 이유
대부분의 Discord 봇은 데이터를 전혀 노출하지 않거나, 인텐트, 게이트웨이 연결, 속도 제한 계산을 직접 다루며 원시 Discord API와 씨름하라고 요구합니다. Noxyr 서버 API는 정반대입니다. 헤더를 보내면 JSON을 받습니다. 여섯 개의 엔드포인트가 서버 소유자가 실제로 묻는 질문에 답합니다. 멤버가 몇 명인지, 이번 주에 티켓이 몇 개 열렸는지, 통화별 매출은 얼마인지, 리뷰 평균 평점은 몇 점인지, 진행 중인 경품 추첨은 무엇인지, 하루 활동 추세가 어떤지입니다.
지금 읽을 수 있는 데이터
GET /api/v1/server: 서버 이름, 아이콘 URL, 실시간 멤버 수, 온라인 수, 부스트, 생성일.GET /api/v1/tickets: 전체 / 열림 / 닫힘 수, 최근 7일과 30일 동안 열린 티켓, 최근 7일 동안 닫힌 티켓, 평균 평점과 평점 수.GET /api/v1/activity?days=30: 최대 90일 동안의 일별 메시지, 입장, 퇴장 수. 모든 날짜가 포함되도록 빈 날은 0으로 채워집니다.GET /api/v1/invoices: 인보이스 수, 7일과 30일 거래량, 통화별 매출, 결제 상태별 분석.GET /api/v1/reviews: 게시된 전체 리뷰 수, 평균 평점, 1~5점 별점 분포, 최신 리뷰 5개(상품, 평점, 짧은 내용, 작성자).GET /api/v1/giveaways: 진행 중 / 종료된 수, 총 참여 수, 곧 끝나는 진행 중 경품 추첨 5개.
보안 모델
키는 nxr_로 시작하며 192비트의 엔트로피를 가집니다. 서버에는 SHA-256 해시만 저장되고, 원본 키는 생성할 때 한 번만 보여 주며 다시 복구할 수 없습니다. 모든 응답은 두 가지 검사를 거칩니다. 키가 활성화되어 있는지, 그리고 이 엔드포인트의 scope가 켜져 있는지입니다. scope를 끄면 즉시 403이 반환되며, 키를 비활성화하거나 취소하면 재배포 없이 모든 접근이 끊깁니다. 속도 제한은 키마다 분당 60회입니다.
시작하기 (60초)
- 1. 대시보드를 열고 서버를 고른 뒤 API Access로 가세요.
- 2. Generate API Key를 누르고 값을 복사하세요. 이 값이 표시되는 유일한 순간입니다.
- 3. scope를 켜거나 끄세요. 각 scope마다 별도의 토글이 있습니다.
- 4.
curl https://noxyrbot.com/api/v1/server -H "Authorization: Bearer nxr_YOUR_KEY"를 호출하면 바로 연결됩니다.
자주 쓰는 연동 예시
랜딩 페이지에 실시간 멤버 카운터를 보여 주세요. 비공개 스태프 채널에 주간 티켓 요약을 올리세요. 경품 추첨 참여가 가장 많은 사람들의 공개 순위표를 만드세요. 매출 데이터를 스프레드시트나 자체 관리자 패널에 연결하세요. 응답이 관대한 CORS 설정과 함께 일반 JSON으로 오기 때문에, 프록시 없이도 브라우저에서 API를 호출할 수 있습니다.
다음 단계
관련 글: Discord API와 Noxyr 서버 API 비교, 단계별 튜토리얼, 이 엔드포인트들의 설계 원칙, 그리고 Discord API 오류를 처리하는 방법.