認証

LISTENの設定画面で発行したPersonal Access TokenをBearerトークンとして送信します。

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json
Content-Type: application/json

curl 'https://listen.style/api/v1/podcasts' \
  -H "Authorization: Bearer $LISTEN_API_TOKEN" \
  -H 'Accept: application/json'

トークンの権限

• read：番組・ストック・利用枠・Webhook設定と履歴の取得。
• create：アップロードの開始・分割URL発行・完了・中断、ビデオストックの登録。
• update：ストック修正・手動紐づけ、RSS再取得、Webhook登録、文字起こし・チャプターのアップロード。
• delete：ストック取消、Webhook削除。

権限があっても他人の番組は操作できません。番組の所有権や対象プランの条件が別途適用されます。

既存のアクセス解析CSVの利用条件は、そのページを参照してください。

トークンはパスワードと同様に扱い、ソースコードやログへ記録しないでください。不要なトークンはLISTENの設定画面から失効させてください。署名付きアップロードURLやWebhook署名キーも公開しないでください。

認証失敗は 401、権限不足は 403 です。エラーメッセージの文言には依存しないでください。