API 개요
LabelGrid 공개 API를 사용하면 개발자가 프로그래밍 방식으로 LabelGrid과 연동할 수 있습니다. 카탈로그를 읽고, 릴리스를 만들고 수정하고, 에셋을 업로드하고, 릴리스를 배포 신청할 수 있습니다.
API가 제공하는 기능
섹션 제목: “API가 제공하는 기능”공개 API는 api.labelgrid.com의 /api/public/... 경로에 마운트되어 있으며, 다음에 대한 프로그래밍 방식 접근을 제공합니다.
- 릴리스: 조회, 생성, 수정, 삭제, 아트워크 업로드, 검증, 배포 신청
- 트랙: 조회, 생성, 수정, 오디오 파일 업로드, 트랙 라이선스 관리
- 레이블: 레이블 프로필 조회 및 관리
- 아티스트: 아티스트 프로필 조회 및 관리
- 작가 및 기여자: 작가/기여자 프로필 조회 및 관리
- 퍼블리셔: 퍼블리셔 프로필 조회 및 관리
- 웹훅: 비동기 알림을 받을 웹훅 엔드포인트 등록
- 참조 데이터: 장르, 언어, 기여자 역할, 악기, 배포 지역, 배포 매장
주요 활용 사례
섹션 제목: “주요 활용 사례”- 기존 시스템에서 릴리스 생성 자동화
- 카탈로그 데이터를 데이터베이스와 동기화
- 맞춤형 대시보드와 리포팅 도구 구축
- 기존 워크플로 도구와 연동
- LabelGrid을 기반으로 화이트라벨 배포 서비스 운영
API 접근 권한 받기
섹션 제목: “API 접근 권한 받기”LabelGrid API를 사용하려면 다음이 필요합니다.
- 요금제에 API 접근이 활성화된 LabelGrid 계정
- 계정 설정에서 발급한 API 토큰: 오른쪽 위 아바타 메뉴를 열고 API Tokens를 클릭하세요(API 접근이 활성화된 경우에만 표시됩니다)
- (선택) 보안 강화를 위한 IP 화이트리스트. 같은 영역에서 설정할 수 있습니다
계정에 API Tokens 옵션이 보이지 않으면 지원팀에 문의하여 요금제에 API 접근 활성화를 상담하세요.
모든 API 요청에는 Authorization 헤더에 Bearer 토큰을 포함해야 합니다.
Authorization: Bearer YOUR_API_TOKENAPI 문서
섹션 제목: “API 문서”전체 엔드포인트 레퍼런스, 요청/응답 스키마, 실시간 “try it” 도구는 자동 생성되는 문서를 참고하세요.
문서에는 다음이 포함되어 있습니다.
- 인증 가이드
- 요청 및 응답 예시가 포함된 모든 엔드포인트
- 요청 한도(rate limit) 정보
- 웹훅 설정
샌드박스
섹션 제목: “샌드박스”LabelGrid은 프로덕션 카탈로그에 영향을 주지 않고 API를 대상으로 개발하고 테스트할 수 있는 샌드박스 환경을 제공합니다. 샌드박스 계정은 요청 시 발급됩니다. 지원팀에 문의하여 설정하세요.
공개 API는 비동기 이벤트 알림(검수 상태 변경, 배포 업데이트 등)을 위한 웹훅을 지원합니다. 설정 방법과 사용 가능한 이벤트 유형은 웹훅을 참고하세요.
관련 문서
섹션 제목: “관련 문서”LabelGrid API로 무언가를 만들고 계신가요? 무엇이 가능한지 한눈에 보려면 개발자 허브를 확인하세요. LabelGrid을 기반으로 화이트라벨 배포 서비스를 운영한다면 배포 사업자를 위한 인프라 페이지에서 전체 그림을 살펴볼 수 있습니다.
도움이 필요하신가요?
섹션 제목: “도움이 필요하신가요?”API 관련 도움이 필요하면 연동에 관한 기술적 세부 정보와 함께 지원팀에 문의하세요.