기간 요약 조회

get

https://stage.openapi.sauce.im/sauce-live/stats/live/{partnerId}/summary

조회 기간에 시작한 Live 방송 전체의 합계·방송당 평균·일평균 방송 수를 조회합니다.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

기간 규칙: PRE_LIVE 일 때 KST 자정 — broadcastStatus=PRE_LIVE 이면 KST 자정에 맞춰야 합니다 기간 규칙 보기

broadcastStatus=LIVE(기본)이면 기간 정렬이 필요 없고, PRE_LIVE 이면 KST 자정 정렬이 필요합니다.
averageDailyBroadcastCount 는 방송 수 ÷ 조회 일수(1일 미만은 1일로 올림)이며 소수 첫째 자리 아래는 버립니다.
averagePlaytime 은 총 시청 시간 ÷ 방송 수(소수점 이하 버림)입니다.
알림 지표(alarm*)는 broadcastStatus=PRE_LIVE 에서만 값이 있고 LIVE 이면 0 입니다.

오류

400 C001 — 필수 파라미터 누락, 날짜 형식 오류(Z 아님·소수 초), searchStartDt ≥ searchEndDt, 시작 시각이 미래, partnerId 형식 오류
400 C005 — broadcastStatus 에 LIVE/PRE_LIVE 이외의 값
400 OA001 — broadcastStatus=PRE_LIVE 인데 기간이 KST 자정(T15:00:00Z)에 맞지 않음
400 OA002 — 조회 기간이 31일 초과

인증·권한·서버 오류 등 공통 오류는 오류 코드를 참고하세요.

Path Params

partnerId

string

required

파트너 ID. 토큰의 파트너와 같아야 합니다.

Query Params

searchStartDt

date-time

required

조회 시작 시각(포함). UTC Z 형식. PRE_LIVE 이면 KST 자정에 맞춰야 합니다.

searchEndDt

date-time

required

조회 종료 시각(미포함). 시작부터 최대 31일. PRE_LIVE 이면 KST 자정에 맞춰야 합니다.

broadcastStatus

string

enum

Defaults to LIVE

LIVE(진행 중 방송, 기본값) 또는 PRE_LIVE(예정 방송). PRE_LIVE 이면 기간을 KST 자정에 맞춰야 합니다.

Allowed:

Headers

x-api-version

string

required

Defaults to 2026-10-28

API 버전 (날짜 형식). 이 명세는 2026-10-28 버전입니다. 없거나 다르면 404 C003 입니다.

X-Request-Id

string

요청 추적 ID(선택). 영문·숫자·- _ . : 128자 이하. 보내지 않거나 형식이 다르면 서버가 만들어 응답 헤더로 돌려줍니다.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

오류

200성공

401Unauthorized — 토큰 없음(G001), 토큰 오류(G002), 토큰 만료(G003), 폐기된 토큰(G004)

403Forbidden — 이 API 권한 없음(G005), 경로의 partnerId 가 토큰의 파트너와 다름(U008)

404Not Found — /sauce-live/stats/ 아래의 없는 경로 또는 x-api-version 헤더 누락·불일치(C003)

405Method Not Allowed — GET 이 아닌 메서드(C002). 응답 헤더 Allow: GET

429Too Many Requests — 파트너별 호출 한도(초당 20회) 초과. 본문 없이 응답합니다. Retry-After 초만큼 기다린 뒤 재시도합니다.

500Internal Server Error — 서버 오류(C004). traceId 와 함께 문의

502API 서버에 연결하지 못함(G013)

503Service Unavailable — 요청이 몰려 처리 대기열이 가득 참(G011) 또는 인증 시스템 일시 장애(G009). 잠시 후 재시도

504API 서버가 60초 안에 응답하지 못함(G012)