채널 일정 API
채널의 방송 일정 조회 및 관리 API입니다.
일정 조회
Endpoint
GET /v1/channels/{channelId}/schedulesRequest
Path Parameters
| Name | Type | Default |
|---|---|---|
channelId | number채널 ID |
Query Parameters
| Name | Type | Default |
|---|---|---|
from | string시작 일시 (ISO 8601) | |
to | string종료 일시 (ISO 8601) |
Response
| Name | Type | Default |
|---|---|---|
schedules | ScheduleResponse[]일정 목록 |
Examples
cURL
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}/schedulesRequest
Request Body
Response
생성된 일정 정보 (ScheduleResponse)가 반환됩니다.
Examples
cURL
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
| Name | Type | Default |
|---|---|---|
channelId | number채널 ID | |
scheduleId | number일정 ID |
수정하려는 필드만 Request Body에 포함합니다. 스키마는 CreateScheduleRequest와 동일하며 모든 필드가 선택 사항입니다.
Examples
cURL
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
cURL
Terminal
curl -X DELETE "https://openapi.meloming.com/v1/channels/1/schedules/456" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"삭제된 일정은 복구할 수 없습니다.
Last updated on