출석 명단 API
현재 채널에 저장된 시청자별 출석 집계를 조회하는 API입니다.
이 API를 사용하려면 read.attendance 권한이 필요합니다.
출석 명단 조회
GET
/api/v1/attendances시청자 UID를 키로 하는 출석 집계 객체를 반환합니다.
요청 정보
이 엔드포인트는 별도의 Query Parameter나 Request Body를 사용하지 않습니다.
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
data | object | 시청자 UID를 키로 갖는 출석 정보 맵 |
data.<viewer_uid> | object | 특정 시청자의 출석 정보 |
data.<viewer_uid>.count | number | 총 출석 횟수 |
data.<viewer_uid>.combo | number | 현재 연속 출석 횟수 |
data.<viewer_uid>.last | string | 마지막 출석 시각 |
응답 구조
data는 배열이 아니라 객체입니다. 각 속성명은 시청자 UID이며, 값으로 해당 시청자의 출석 요약이 들어갑니다.
{
"success": true,
"data": {
"4c3a50fe635854036b4dcf15c9a4d0a2": {
"count": 21,
"combo": 2,
"last": "2025-12-14 15:00:04"
}
}
}
출석 데이터가 없는 경우 data는 빈 객체 {} 로 반환됩니다.
요청
응답
응답