인증 방법
뚜봇 API를 사용하려면 API 키를 발급받아 인증해야 합니다.
API 키 발급
1
대시보드 접속
뚜봇 대시보드에 로그인합니다.
2
설정 메뉴 이동
좌측 메뉴에서 '설정' → 'API 설정'을 클릭합니다.
3
API 키 생성
'API 키 생성' 버튼을 클릭하고, 필요한 권한(Scope)을 선택합니다.
4
키 복사
생성된 API 키를 안전한 곳에 저장합니다.
API 키는 한 번만 표시됩니다. 분실 시 새로 발급받아야 합니다.
인증 방법
Authorization 헤더
모든 API 요청에 Authorization 헤더를 포함합니다.
Authorization: DDUBOT_API <api_key>
예시
cURL:
curl -X GET "https://chzzk-bot.ddutto.com/api/v1/roulette" \
-H "Authorization: DDUBOT_API YOUR_API_KEY"
JavaScript (fetch):
const response = await fetch('https://chzzk-bot.ddutto.com/api/v1/roulette', {
method: 'GET',
headers: {
'Authorization': 'DDUBOT_API YOUR_API_KEY'
}
});
const data = await response.json();
Python (requests):
import requests
headers = {
'Authorization': 'DDUBOT_API YOUR_API_KEY'
}
response = requests.get(
'https://chzzk-bot.ddutto.com/api/v1/roulette',
headers=headers
)
data = response.json()
권한 (Scope)
API 키 생성 시 필요한 권한을 선택해야 합니다.
| Scope | 설명 |
|---|---|
read.roulette | 룰렛 목록 및 로그 조회 |
read.song-request | 신청곡 대기열 조회 |
read.karaoke | 노래방 대기열/완료 목록 조회 |
read.viewer_info | 시청자 정보 조회 |
Rate Limit
모든 API는 분당 15회의 요청 제한이 있습니다.
응답 헤더에서 Rate Limit 정보를 확인할 수 있습니다:
| 헤더 | 설명 |
|---|---|
X-RateLimit-Limit | 분당 최대 요청 수 (15) |
X-RateLimit-Remaining | 남은 요청 수 |
X-RateLimit-Reset | 제한 초기화 시간 (Unix timestamp) |
오류 응답
인증 실패 시 다음과 같은 오류가 반환됩니다:
{
"success": false,
"error": "인증에 실패했습니다."
}
일반적인 오류 원인
- API 키가 유효하지 않음
- API 키가 만료됨
- 필요한 Scope 권한이 없음
- Rate Limit 초과
API 키 관리
키 재발급
대시보드에서 언제든지 새 API 키를 발급받을 수 있습니다. 새 키 발급 시 기존 키는 자동으로 무효화됩니다.
키 삭제
API 키가 유출된 경우 즉시 대시보드에서 삭제하고 새로 발급받으세요.
API 키를 공개 저장소나 클라이언트 코드에 노출하지 마세요.