GuidesAPI GuideChangelog
Log In
API Guide

라이브 편성

최소 정보로 라이브 방송을 생성합니다. 생성된 방송은 승인 대기 상태입니다.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
  • 성공하면 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 — 동시 송출 한도 초과

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

Path Params
string
required

파트너 ID. 토큰의 파트너와 같아야 합니다. 영문·숫자·-·_ 4~20자.

Body Params
string
required
length between 2 and 30

방송명. 2~30자

string
enum
required

방송 타입(live-라이브). live 만 허용

Allowed:
string
enum
required

화면 비율(9:16-세로|16:9-가로). 생성 후 변경할 수 없습니다

Allowed:
date-time
required

라이브 시작 시각. 오프셋을 포함한 ISO 8601(Z 또는 +09:00). 현재 시각 + 5분보다 뒤여야 합니다

date-time
required

라이브 종료 시각. 오프셋을 포함한 ISO 8601. 시작보다 뒤이고 시작 + 24시간 이내여야 합니다

string
enum
required

공개 방식(basic-일반|secret-시크릿). secret 이면 모아보기·쇼룸에 노출되지 않습니다

Allowed:
boolean | null

시청 비밀번호 사용 여부. true 면 broadcastSecretTypeCode 가 secret 이어야 합니다

string | null

시청 비밀번호. secret + broadcastUsePassword=true 일 때 필수, 4자 이상. 그 외에는 저장하지 않습니다

boolean
required

테스트 방송 여부. true 면 동시 송출 한도 계산에서 빠지고 모아보기·쇼룸에 노출되지 않습니다

string | null

대분류 카테고리 ID. 방송 카테고리 조회의 mainCategoryId. 없으면 ETC(기타)

string | null

중분류 카테고리 ID. 방송 카테고리 조회의 subCategoryId. broadcastCategoryId1 소속이어야 합니다. 없으면 {대분류ID}#ETC(대분류의 기타)

string
required
length ≤ 64

관리자 계정 ID. 계층 조회의 serviceAdminId

string | null

매니저 계정 ID. 계층 조회의 serviceManagerId. serviceAdminId 소속이어야 합니다

string | null

운영자 계정 ID. 계층 조회의 serviceOperatorId. 보내면 serviceManagerId 도 필수이고 그 소속이어야 합니다

Headers
string
required
Defaults to 2026-11-18

API 버전 (날짜 형식). 방송 API 는 2026-11-18 입니다. 없거나 다르면 400 C001 입니다.

string

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

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.