채널 노래책 API
채널의 노래 목록 관리, 통합 검색, 카테고리 및 아티스트 API입니다.
노래 목록 조회
Endpoint
GET /v1/channels/{channelId}/songsRequest
Path Parameters
| Name | Type | Default |
|---|---|---|
channelId | number채널 ID |
Query Parameters
Response
| Name | Type | Default |
|---|---|---|
songs | SongResponse[]노래 목록 | |
total | number전체 개수 | |
page | number현재 페이지 | |
limit | number페이지 크기 |
Examples
cURL
Terminal
# 기본 조회
curl "https://openapi.meloming.com/v1/channels/1/songs"
# 검색 + 필터
curl "https://openapi.meloming.com/v1/channels/1/songs?search=봄날&sortBy=newest&limit=20"노래 상세 조회
Endpoint
GET /v1/channels/{channelId}/songs/{songId}Request
Path Parameters
| Name | Type | Default |
|---|---|---|
channelId | number채널 ID | |
songId | number노래 ID |
Response
응답 스키마는 노래 목록 조회의 SongResponse와 동일합니다.
Examples
cURL
Terminal
curl https://openapi.meloming.com/v1/channels/1/songs/123노래 추가
인증 필요 - OAuth Access Token
Endpoint
POST /v1/channels/{channelId}/songsRequest
Request Body
Response
생성된 노래 정보 (SongResponse)가 반환됩니다.
Examples
cURL
Terminal
curl -X POST "https://openapi.meloming.com/v1/channels/1/songs" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "노래 제목",
"artistId": 1,
"difficulty": 3,
"proficiency": 4
}'노래 수정
인증 필요 - 채널 소유자만 가능
Endpoint
PATCH /v1/channels/{channelId}/songs/{songId}Request
수정하려는 필드만 Request Body에 포함합니다. 스키마는 CreateSongRequest와 동일하며 모든 필드가 선택 사항입니다.
Examples
cURL
Terminal
curl -X PATCH "https://openapi.meloming.com/v1/channels/1/songs/123" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "수정된 제목", "difficulty": 4}'노래 삭제
인증 필요 - 채널 소유자만 가능
Endpoint
DELETE /v1/channels/{channelId}/songs/{songId}Examples
cURL
Terminal
curl -X DELETE "https://openapi.meloming.com/v1/channels/1/songs/123" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"노래 통합 검색
모든 채널에서 노래를 검색합니다.
Endpoint
GET /v1/songs/searchRequest
Query Parameters
| Name | Type | Default |
|---|---|---|
q | string검색어 (제목, 아티스트명) | |
artistId | number아티스트 ID 필터 | |
categoryId | number카테고리 ID 필터 | |
sortBy | "newest" | "oldest" | "title" | "artist"정렬 기준 | "newest" |
page | number페이지 번호 | 1 |
limit | number결과 수 (최대 100) | 20 |
Response
| Name | Type | Default |
|---|---|---|
items | GlobalSongSearchItem[]검색 결과 목록 | |
pagination | Pagination페이지네이션 정보 |
Examples
cURL
Terminal
curl "https://openapi.meloming.com/v1/songs/search?q=봄날&limit=20"채널 카테고리
채널에서 사용 중인 노래 카테고리 목록을 조회합니다.
Endpoint
GET /v1/channels/{channelId}/categoriesResponse
| Name | Type | Default |
|---|---|---|
id | number카테고리 ID | |
name | string카테고리명 | |
channelId | number채널 ID | |
songCount | number해당 카테고리의 노래 수 |
Examples
cURL
Terminal
curl https://openapi.meloming.com/v1/channels/1/categories채널 아티스트
채널에 등록된 아티스트 목록을 조회합니다.
Endpoint
GET /v1/channels/{channelId}/artistsResponse
| Name | Type | Default |
|---|---|---|
id | number아티스트 ID | |
name | string아티스트명 | |
channelId | number채널 ID | |
songCount | number해당 아티스트의 노래 수 |
Examples
cURL
Terminal
curl https://openapi.meloming.com/v1/channels/1/artistsLast updated on