Skip to Content
OpenAPIAPI 레퍼런스채널 일정 API

채널 일정 API

채널의 방송 일정 조회 및 관리 API입니다.


일정 조회

Endpoint
GET /v1/channels/{channelId}/schedules

Request

Path Parameters

NameTypeDefault
channelIdnumber

채널 ID

Query Parameters

NameTypeDefault
fromstring

시작 일시 (ISO 8601)

tostring

종료 일시 (ISO 8601)

Response

NameTypeDefault
schedulesScheduleResponse[]

일정 목록

Examples

Terminal
curl "https://openapi.meloming.com/v1/channels/1/schedules?from=2025-01-01T00:00:00Z&to=2025-01-31T23:59:59Z"

일정 추가

인증 필요 - OAuth Access Token

Endpoint
POST /v1/channels/{channelId}/schedules

Request

Request Body

NameTypeDefault
titlestring

일정 제목 (필수)

startAtstring

시작 시간 (ISO 8601, 필수)

endAtstring

종료 시간 (ISO 8601)

contentstring

내용

allDayboolean

종일 여부

false
status"LIVE" | "VOD" | "OFFLINE"

상태

"LIVE"
visibility"PUBLIC" | "PRIVATE"

공개 범위

"PUBLIC"
locationstring

장소/플랫폼

externalUrlstring

외부 링크

Response

생성된 일정 정보 (ScheduleResponse)가 반환됩니다.

Examples

Terminal
curl -X POST "https://openapi.meloming.com/v1/channels/1/schedules" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "정규 방송", "startAt": "2025-01-15T20:00:00+09:00", "endAt": "2025-01-15T23:00:00+09:00", "status": "LIVE", "visibility": "PUBLIC" }'

일정 수정

인증 필요 - 채널 소유자만 가능

Endpoint
PATCH /v1/channels/{channelId}/schedules/{scheduleId}

Request

Path Parameters

NameTypeDefault
channelIdnumber

채널 ID

scheduleIdnumber

일정 ID

수정하려는 필드만 Request Body에 포함합니다. 스키마는 CreateScheduleRequest와 동일하며 모든 필드가 선택 사항입니다.

Examples

Terminal
curl -X PATCH "https://openapi.meloming.com/v1/channels/1/schedules/456" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "수정된 방송 제목", "startAt": "2025-01-15T21:00:00+09:00" }'

일정 삭제

인증 필요 - 채널 소유자만 가능

Endpoint
DELETE /v1/channels/{channelId}/schedules/{scheduleId}

Examples

Terminal
curl -X DELETE "https://openapi.meloming.com/v1/channels/1/schedules/456" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

삭제된 일정은 복구할 수 없습니다.

Last updated on