LISTEN API

LISTEN APIは、番組・エピソードの取得や、番組運営を自動化するためのGraphQL APIです。

エンドポイント

POST https://listen.style/graphql

リクエスト本文はJSONで、queryと必要に応じてvariablesを指定します。

{
  "query": "query { me { id name } }"
}

利用の流れ

1. LISTENの設定画面でAPIトークンを発行します。
2. Authorization: Bearer ...ヘッダーを付けてGraphQL APIを呼び出します。
3. errorsが返った場合は、メッセージを確認してリクエストを修正します。

主なAPI

• データ取得: 番組・エピソード・ユーザーの取得や検索を行います。
• エピソード管理: エピソードの作成・更新・削除を行います。
• リスナー操作: フォロー、再生位置、コメント、プレイリストを操作します。
• ファイルアップロード: 音声・ビデオ・画像をLISTENへ直接アップロードします。
• RSS再取得: 外部配信番組のRSSを優先キューで再取得します。
• ビデオストック: RSS公開前にビデオを登録し、後からエピソードへ自動で紐づけます。

APIは予告なく破壊的変更を行わないよう努めます。制限値や対応形式を変更する場合は、このドキュメントを更新します。