이 API를 사용하려면 read.song-request 권한이 필요해요.
키는 한글이라 헤더에 넣기 전에 퍼센트 인코딩해야 해요. 인증 방법 →
신청곡 대기열 조회
GET
/api/v1/song-requests완료되지 않은 신청곡 목록을 순서대로 조회해요.
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
data | array | 신청곡 목록 |
data[].id | number | 신청곡 고유 ID (2026-08 추가) |
data[].title | string | 곡 제목 |
data[].videoId | string | 유튜브 영상 ID |
data[].duration | number | 영상 길이(초) |
data[].requester.name | string | 신청자 닉네임 (익명 신청이면 "익명" 고정) |
data[].requester.uid | string | 신청자 UID (익명 신청이면 "anonymous" 고정) |
data[].requester.isAnonymous | boolean | 익명 신청 여부 |
data[].requestTime | number | 신청 시각(ms) |
data[].sortOrder | number | 정렬 순서 값 |
data[].priority | number | 우선순위 |
eventTimestamp | number | 서버 이벤트 시각(ms) |
요청
curl -X GET "https://chzzk-bot.ddutto.com/api/v1/song-requests" \
-H "Authorization: DDUBOT_API %EB%AF%B8%EB%A6%AC-%EC%9D%B8%EC%BD%94%EB%94%A9%ED%95%9C-%ED%82%A4"응답
{
"success": true,
"data": [
{
"id": 1243923,
"title": "예시 곡",
"videoId": "dQw4w9WgXcQ",
"duration": 213,
"requester": {
"name": "테스트유저",
"uid": "4c3a50fe635854036b4dcf15c9a4d0a2",
"isAnonymous": false
},
"requestTime": 1769448705123,
"sortOrder": 1000,
"priority": 0
}
],
"eventTimestamp": 1769448706000
}응답
{
"success": false,
"data": {
"error": "권한이 없습니다. 'read.song-request' scope가 필요합니다."
}
}