API 概要

LabelGrid の公開 API を使うと、開発者はプログラムから LabelGrid と連携できます。カタログの読み取り、リリースの作成・更新、アセットのアップロード、配信のためのリリース送信などが可能です。

API でできること

公開 API は api.labelgrid.com 上の /api/public/... に配置されており、次のリソースにプログラムからアクセスできます。

• リリース - 一覧取得、作成、更新、削除、アートワークのアップロード、検証、配信送信
• トラック - 一覧取得、作成、更新、音源ファイルのアップロード、トラックライセンスの管理
• レーベル - レーベルプロフィールの一覧取得と管理
• アーティスト - アーティストプロフィールの一覧取得と管理
• ライター・コントリビューター - ライター／コントリビューターのプロフィールの一覧取得と管理
• パブリッシャー - パブリッシャープロフィールの一覧取得と管理
• Webhook - 非同期通知を受け取るための Webhook エンドポイントの登録
• 参照データ - ジャンル、言語、コントリビューターの役割、楽器、配信地域、配信先

主な活用例

• 既存システムからのリリース作成を自動化する
• カタログデータを自社データベースと同期する
• 独自のダッシュボードやレポートツールを構築する
• 既存のワークフローツールと連携する
• LabelGrid を基盤としたホワイトラベルの配信サービスを提供する

---

API アクセスの取得

LabelGrid の API を利用するには、次のものが必要です。

1. プランで API アクセスが有効 になっている LabelGrid アカウント
2. アカウント設定で生成した API トークン。右上のアバターメニューを開き、API Tokens をクリックします（API アクセスが有効な場合のみ表示されます）
3. （任意）セキュリティを高めるための IP ホワイトリスト。同じ画面で設定できます

アカウントに API Tokens の項目が表示されない場合は、サポートにお問い合わせのうえ、プランでの API アクセス有効化についてご相談ください。

---

認証

すべての API リクエストでは、Authorization ヘッダーに Bearer トークンを含める必要があります。

Authorization: Bearer YOUR_API_TOKEN

---

API ドキュメント

エンドポイントの完全なリファレンス、リクエスト／レスポンスのスキーマ、その場で試せる「Try it」ツールについては、自動生成されたドキュメントをご覧ください。

• 本番環境: https://api.labelgrid.com/docs/api
• サンドボックス: https://api-sandbox.stg.labelgrid.com/docs/api

ドキュメントには次の内容が含まれます。

• 認証ガイド
• 利用可能なすべてのエンドポイントと、リクエスト／レスポンスの例
• レート制限に関する情報
• Webhook の設定方法

---

サンドボックス

LabelGrid では、本番のカタログに影響を与えずに API の開発とテストを行えるサンドボックス環境を用意しています。サンドボックスアカウントはリクエストに応じて発行します。サポートにお問い合わせのうえ、ご準備ください。

---

Webhook

公開 API は、イベントの非同期通知（審査ステータスの変更、配信の更新など）のための Webhook に対応しています。設定方法と利用可能なイベントの種類については、Webhook をご覧ください。

---

関連情報

LabelGrid API での開発をお考えですか？できることの概要は、開発者向けハブ をご覧ください。LabelGrid を基盤としたホワイトラベルの配信サービスを提供する場合は、ディストリビューター向けインフラのページで全体像を確認できます。

---

サポートが必要ですか？

API についてサポートが必要な場合は、連携の技術的な詳細を添えてサポートチームにお問い合わせください。