멜로밍 OpenAPI
멜로밍 플랫폼의 채널, 노래, 콘텐츠 데이터에 프로그래매틱하게 접근할 수 있는 RESTful API입니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 채널 | 채널 정보 조회, 검색, 랭킹 및 프로필 관리 API |
| 노래 | 채널별 노래 목록 조회, 검색, 추가/수정/삭제 |
| 일정 | 채널의 방송 일정 조회 및 관리 |
| 콘텐츠 | 공모전, 이벤트 등 콘텐츠 정보 접근 |
| 인증 | OAuth 2.0 및 API Key 지원 |
| Rate Limit | 티어별 요청 제한으로 안정적인 서비스 보장 |
빠른 시작
공개 API 호출 (인증 불필요)
GET 요청은 인증 없이 바로 사용할 수 있습니다.
# 채널 정보 조회
curl https://openapi.meloming.com/v1/channels/1
# 채널 검색
curl "https://openapi.meloming.com/v1/channels/search?q=멜로밍"
# 노래 검색
curl "https://openapi.meloming.com/v1/songs/search?q=봄날"OAuth 토큰 발급 (쓰기 작업용)
채널/콘텐츠 관리 API는 사용자 권한 확인이 필요하므로 OAuth 2.0 Access Token이 필요합니다. 애플리케이션 등록하기에서 클라이언트를 생성한 뒤 토큰을 발급하세요.
인증된 API 호출
Authorization 헤더에 OAuth Access Token을 포함하여 요청합니다.
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}'사용량 제한
안정적인 서비스를 위해 티어별 사용량 제한이 적용됩니다.
| 티어 | 요청/분 | 월간 한도 |
|---|---|---|
| Free | 60 | 10,000 |
| Pro | 300 | 100,000 |
| Enterprise | 1,000 | 무제한 |
응답 헤더에서 사용량을 확인할 수 있습니다.
- Rate Limit:
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset - Quota (API Key 사용 시):
X-Quota-Limit,X-Quota-Used,X-Quota-Remaining,X-Quota-Reset
Base URL
https://openapi.meloming.com현재 API 버전: 2026-01-11
버전 지정 헤더: Meloming-Version (YYYY-MM-DD). 미지정 시 최신 버전이 사용됩니다.
개발 리소스
- API 레퍼런스 - 모든 엔드포인트, 요청/응답 형식, 에러 코드 상세 문서
- 인증 가이드 - OAuth 2.0 및 API Key 인증 방법과 보안 모범 사례
- Swagger UI - 브라우저에서 직접 API 테스트
- OpenAPI 스펙 - OpenAPI 3.0 JSON 스펙 다운로드
Last updated on