신청곡 API
현재 채널의 신청곡 대기열을 조회하는 API입니다.
이 API를 사용하려면 read.song-request 권한이 필요합니다.
신청곡 대기열 조회
GET
/api/v1/song-requests완료되지 않은 신청곡 목록을 순서대로 조회합니다.
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
data | array | 신청곡 목록 |
data[].title | string | 곡 제목 |
data[].videoId | string | 유튜브 영상 ID |
data[].duration | number | 영상 길이(초) |
data[].requester.name | string | 신청자 닉네임 |
data[].requester.uid | string | 신청자 UID |
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 YOUR_API_KEY"응답
{
"success": true,
"data": [
{
"title": "예시 곡",
"videoId": "dQw4w9WgXcQ",
"duration": 213,
"requester": {
"name": "테스트유저",
"uid": "4c3a50fe635854036b4dcf15c9a4d0a2",
"isAnonymous": false
},
"requestTime": 1769448705123,
"time": 1769448705123,
"sortOrder": 1000,
"priority": 0
}
],
"eventTimestamp": 1769448706000
}응답
{
"success": false,
"data": {
"error": "권한이 없습니다. 'read.song-request' scope가 필요합니다."
}
}