실시간 Discord 배지 생성 가이드
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
웹 개발
대상자
- *대상자**: 웹 개발자 및 GitHub 사용자
- *난이도**: 중급 (Discord API, Redis 캐싱, rate limit 처리 기술 필요)
핵심 요약
- Discord Server Widget API 사용하여 실시간 멤버 수 추출 (예:
https://discord.com/api/guilds/{guildId}?with_counts=true) - Redis 캐싱으로 API 요청 성능 최적화 (캐시 키:
guild:{guildId}:members) - 429 rate limit 대응을 위한
retry_after기반 재시도 로직 구현 - GitHub Readme에 맞춤형 배지 생성 (색상, 라벨, 크기 조정 가능)
섹션별 세부 요약
1. 배지 생성 목적
- GitHub Readme에 실시간 Discord 멤버 수 표시로 프로젝트 활동성 강조
- 커뮤니티 신뢰도 향상 및 기여자 유치 효과
- 경쟁사 서버 ID를 통해 실시간 데이터 비교 가능 (주의: 비공식적 사용 권장 X)
2. 구현 단계
- Discord Bot 생성:
- View Channels, Manage Channels 권한 부여
- Presence Intent 및 Server Members Intent 활성화
- API 연동:
- axios.get으로 /guilds/{guildId}?with_counts=true 호출
- fetchAllMembers()로 봇/인간 멤버 수 분리
- 캐싱 구현:
- Redis 사용 (예: redis.get(cacheKey))
- CACHE_TTL 환경 변수로 캐시 유효 시간 관리
3. 커스터마이징 기능
- 색상:
color파라미터로 HEX 값 지정 (예:color=7289DA) - 레이블:
label파라미터로 커스텀 텍스트 설정 (예:label=Members) - 크기 조정:
scale파라미터로 0.5~10.0 범위 지정 - 웹 인터페이스: 실시간 미리보기, Markdown 코드 생성 지원
4. 성능 최적화
- Redis 캐싱: 반복 요청 감소 (캐시 히트 시
JSON.parse(cached)활용) - Rate Limiting:
429응답 시setTimeout으로retry_after대기 - 비동기 처리:
Promise로 API 요청/캐싱 병렬 처리
결론
- GitHub Readme에 실시간 Discord 배지 추가로 커뮤니티 성장 지표 시각화 가능
- Redis + Discord API 활용하여 성능과 안정성 확보
- 공식 도구가 없는 경우, 제공된
badge-maker패키지와 웹 생성기 사용 권장 - 주의: 경쟁사 서버 ID 스니크 피크는 윤리적 문제 발생 가능 (공식 사용 권장)