API 개요 및 빠른 시작
2026년 7월 업데이트.
네, LabelGrid는 프로그래밍 방식 유통을 위한 공개 REST API를 제공해요. 개발자는 이 API로 카탈로그를 읽고, 릴리스를 만들고 업데이트하며, 자산을 업로드하고, 유통을 위해 릴리스를 제출할 수 있어요. LabelGrid를 기반으로 하는 화이트 라벨 서비스도 이 API로 구동되죠. 이 가이드는 빠른 시작 안내이며, 전체 엔드포인트 레퍼런스는 api.labelgrid.com/docs/api에 있어요.
빠른 시작 한눈에 보기
섹션 제목: “빠른 시작 한눈에 보기”| 단계 | 할 일 |
|---|---|
| 1. API 플랜 활성화 | API와 샌드박스 접근에는 활성화된 유료 API 플랜(연간 청구)이 필요해요. |
| 2. API 토큰 생성 | 오른쪽 상단 아바타 메뉴를 열고 API Tokens를 클릭해 Bearer 토큰을 만드세요. |
| 3. (선택) IP 화이트리스트 | 같은 API Tokens 영역에서 알려진 IP로만 토큰 사용을 제한하세요. |
| 4. 레퍼런스 읽기 | api.labelgrid.com/docs/api에서 엔드포인트와 “try it” 도구를 살펴보세요. |
| 5. 샌드박스에서 개발 | 지원팀에 샌드박스를 요청한 뒤 프로덕션을 건드리지 않고 테스트하세요. |
| 6. 프로덕션으로 전환 | 연동 대상을 api.labelgrid.com으로 지정하고 첫 릴리스를 만드세요. |
API가 제공하는 것
섹션 제목: “API가 제공하는 것”공개 API는 api.labelgrid.com의 /api/public/... 아래에 마운트되며, 다음에 대한 프로그래밍 방식 접근을 제공해요.
- 릴리스 — 목록 조회, 생성, 업데이트, 삭제, 아트워크 업로드, 검증, 유통 제출
- 트랙 — 목록 조회, 생성, 업데이트, 오디오 파일 업로드, 트랙 라이선스 관리
- 레이블 — 레이블 프로필 목록 조회 및 관리
- 아티스트 — 아티스트 프로필 목록 조회 및 관리
- 작가 및 기여자 — 작가/기여자 프로필 목록 조회 및 관리
- 퍼블리셔 — 퍼블리셔 프로필 목록 조회 및 관리
- 웹훅 — 비동기 알림을 위한 웹훅 엔드포인트 등록
- 참조 데이터 — 장르, 언어, 기여자 역할, 악기, 유통 지역, 유통 아울렛
일반적인 사용 사례
섹션 제목: “일반적인 사용 사례”- 기존 시스템에서 릴리스 생성 자동화
- 카탈로그 데이터를 데이터베이스와 동기화
- 맞춤형 대시보드 및 리포팅 도구 구축
- 기존 워크플로 도구와 통합
- LabelGrid 위에 화이트 라벨 유통 서비스 구동
API 접근 권한 얻기
섹션 제목: “API 접근 권한 얻기”LabelGrid API를 사용하려면 다음이 필요해요.
- 활성화된 유료 API 플랜 — API 및 샌드박스 접근에는 유료 API 플랜이 필요해요. 표준 플랜에 딸린 7일 무료 체험에는 API나 샌드박스 접근이 포함되지 않으며, API 플랜은 (체험 기간 없이) 즉시 청구돼요.
- 계정 설정에서 생성한 API 토큰 — 오른쪽 상단의 아바타 메뉴를 열고 API Tokens를 클릭하세요(API 접근이 활성화된 경우에만 표시돼요)
- (선택) 보안 강화를 위한 IP 화이트리스트 — 동일한 영역에서 설정하세요
계정에 API Tokens 옵션이 보이지 않는다면, 플랜에서 API 접근을 활성화하는 방안을 논의하기 위해 지원팀에 문의하세요.
모든 API 요청은 Authorization 헤더에 Bearer 토큰을 포함해야 해요.
Authorization: Bearer YOUR_API_TOKENAPI 문서
섹션 제목: “API 문서”전체 엔드포인트 레퍼런스, 요청/응답 스키마, 그리고 라이브 “try it” 도구는 자동 생성된 문서를 참고하세요.
문서에 포함된 내용:
- 인증 가이드
- 요청 및 응답 예시가 포함된 모든 엔드포인트
- 속도 제한(rate-limiting) 정보
- 웹훅 구성
샌드박스
섹션 제목: “샌드박스”LabelGrid는 프로덕션 카탈로그에 영향을 주지 않고 API를 대상으로 빌드하고 테스트할 수 있도록 샌드박스 환경을 제공해요. 샌드박스 접근에는 활성화된 API 플랜이 필요하며 요청 시 저희가 프로비저닝해 드려요. API 플랜이 활성화되면 지원팀에 문의하셔서 설정하세요. 샌드박스 IP 화이트리스트는 저희가 구성해 드리고, 프로덕션 IP 화이트리스트는 API Tokens 아래에서 직접 설정할 수 있어요.
공개 API는 비동기 이벤트 알림(검토 상태 변경, 전송 업데이트 등)을 위한 웹훅을 지원해요. 설정 방법과 이용 가능한 이벤트 유형은 웹훅을 참고하세요.
FAQ
섹션 제목: “FAQ””LabelGrid에 공개 API가 있나요?”
섹션 제목: “”LabelGrid에 공개 API가 있나요?””네, LabelGrid는 프로그래밍 방식 유통을 위한 공개 REST API를 제공해요. api.labelgrid.com의 /api/public/... 아래에 마운트되어 있으며, 카탈로그 조회, 릴리스 생성 및 업데이트, 오디오와 아트워크 업로드, 아티스트 및 기여자 관리, 웹훅 등록, 유통 제출까지 할 수 있어요. 전체 문서는 api.labelgrid.com/docs/api에서 확인할 수 있어요.
”API 접근 권한은 어떻게 얻나요?”
섹션 제목: “”API 접근 권한은 어떻게 얻나요?””API와 샌드박스 접근에는 활성화된 유료 API 플랜이 필요해요. API 플랜이 활성화되면 계정 설정의 API Tokens(오른쪽 상단 아바타 메뉴)에서 API 토큰을 생성하세요. 해당 옵션이 보이지 않는다면 지원팀에 문의해 API 접근을 활성화하세요. 표준 플랜의 7일 무료 체험에는 API 접근이 포함되지 않아요.
”API 요청은 어떻게 인증하나요?”
섹션 제목: “”API 요청은 어떻게 인증하나요?””모든 요청의 Authorization 헤더에 Bearer 토큰을 포함하세요. 형식은 Authorization: Bearer YOUR_API_TOKEN이에요. 토큰은 계정 설정의 API Tokens에서 생성하며, 필요하면 IP 화이트리스트로 사용을 제한할 수 있어요.
”테스트용 샌드박스 환경이 있나요?”
섹션 제목: “”테스트용 샌드박스 환경이 있나요?””네. LabelGrid는 프로덕션 카탈로그에 영향을 주지 않고 API를 대상으로 빌드하고 테스트할 수 있는 샌드박스를 제공해요. 샌드박스 접근에는 활성화된 API 플랜이 필요하며 요청 시 프로비저닝해 드리니, API 플랜이 활성화되면 지원팀에 문의하세요. 샌드박스 문서는 api-sandbox.stg.labelgrid.com/docs/api에서 확인할 수 있어요.
”LabelGrid API 비용은 얼마인가요?”
섹션 제목: “”LabelGrid API 비용은 얼마인가요?””API는 연간 청구되는 LabelGrid API 플랜에서 제공돼요. 플랜은 Starter API 등급부터 시작하며, 더 큰 카탈로그와 더 높은 로열티 처리 한도를 위한 상위 등급도 있어요. 현재 가격과 등급별 세부 정보는 요금제 페이지를 참고하세요.
LabelGrid API 위에서 빌드하고 계신가요? 가능한 것의 개요는 개발자 허브를 참고하세요. LabelGrid 위에 화이트 라벨 유통 서비스를 구동한다면, 배급사를 위한 인프라 페이지에서 더 큰 그림을 다뤄요. 화이트 라벨 유통 설정 가이드도 함께 참고하세요.
도움이 필요하세요?
섹션 제목: “도움이 필요하세요?”API 지원이 필요하다면, 통합에 관한 기술적 세부 정보와 함께 지원팀에 문의하세요.