post
https://stage.openapi.sauce.im/sauce-live/broadcasts/
최소 정보로 라이브 방송을 생성합니다. 생성된 방송은 승인 대기 상태입니다.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
- 성공하면
201과 함께broadcastId·shortUrl·approvalTypeCode를 돌려줍니다. - 생성된 방송은 승인 대기(
approvalTypeCode: pending) 상태입니다. 썸네일·상품 등 나머지 정보는 소스라이브 어드민에서 채워 주세요. - 담당자 ID 는 관리자·매니저·운영자 계층 조회, 카테고리 ID 는 방송 카테고리 조회 응답 값을 씁니다.
편성 시각
- 오프셋을 포함한 ISO 8601 로 보냅니다. 예:
2026-11-10T11:00:00Z,2026-11-10T20:00:00+09:00(둘은 같은 시각입니다) - 오프셋이 없는 값(
2026-11-10T11:00:00)은 거부합니다. - 시작 시각은 현재 시각 + 5분보다 뒤여야 합니다.
- 종료 시각은 시작보다 뒤이고, 시작부터 24시간 이내여야 합니다.
담당자
| 보낸 값 | 결과 |
|---|---|
| 관리자만 | 관리자가 담당합니다 |
| 관리자 + 매니저 | 매니저가 그 관리자 소속이어야 합니다 |
| 관리자 + 매니저 + 운영자 | 운영자가 그 매니저 소속이어야 합니다 |
| 관리자 + 운영자 (매니저 없음) | 400 C001 |
카테고리
| 보낸 값 | 결과 |
|---|---|
| 둘 다 없음 | 기타(ETC) · 기타(ETC#ETC) |
| 대분류만 | 그 대분류의 기타({대분류ID}#ETC) |
| 대분류 + 중분류 | 중분류가 그 대분류 소속이어야 합니다 |
파트너에 없거나 삭제된 카테고리는 400 C001 입니다.
동시 송출 한도
같은 시간대에 편성된 라이브 방송 수가 파트너의 동시 송출 한도에 도달하면 422 B001 로 거부합니다. 테스트 방송(isTest: true)은 한도 계산에 포함하지 않습니다.
공개 범위
| 조건 | 모아보기·쇼룸 |
|---|---|
| 일반 방송 | 공개 |
broadcastSecretTypeCode: secret 또는 isTest: true | 비공개 |
시청 비밀번호는 secret + broadcastUsePassword: true 일 때만 저장합니다.
응답을 받지 못해 같은 요청을 다시 보내면 방송이 하나 더 생성됩니다. 재전송 전에 소스라이브 어드민에서 방송이 생성됐는지 확인해 주세요.
오류
- 400 C001 — 필수 값 누락·형식 오류, 편성 시각 규칙 위반, 시크릿·비밀번호 규칙 위반, 없거나 짝이 맞지 않는 카테고리, 계층 관계가 맞지 않는 담당자,
x-api-version헤더 누락·불일치.errors의field·reason으로 원인을 알려 드립니다. - 403 U008 — 경로의
partnerId가 토큰의 파트너와 다름 - 403 P002 — 사용 중지된 파트너
- 404 P001 — 파트너 정보 없음
- 422 B001 — 동시 송출 한도 초과
인증·권한·서버 오류 등 공통 오류는 오류 코드를 참고하세요.
