Transistor MCP

🚀 Transistor API 日本語ドキュメント

Transistor は、ポッドキャストコンテンツを管理するための一連の RESTful API を提供しています。これらの API を使用すると、エピソードの作成、更新、削除、分析データの取得、購読者の管理、およびオーディオファイルのアップロードが可能です。

📚 ドキュメント

✨ 主な機能

Transistor API を使用すると、以下の操作が可能です。

• ポッドキャストのエピソードを作成、更新、削除する。
• エピソードの分析データを取得する。
• 購読者を管理する。
• オーディオファイルをアップロードする。

📦 インストール

この API は RESTful API であり、HTTP リクエストを使用して呼び出すことができます。特別なインストール手順は必要ありません。

💻 使用例

エピソードの作成

import requests

response = requests.post('https://api.transistor.fm/v1/episodes', json={
    'show_id': '12345',
    'title': '我的新剧集',
    'description': '这是一个关于播客的新剧集。',
    'episode_number': 1,
    'season_number': 1,
    'audio_url': 'https://example.com/episode.mp3'
})
print(response.json())

分析データの取得

import requests

response = requests.get('https://api.transistor.fm/v1/analytics/episodes/12345')
print(response.json())

🔧 技術詳細

API リファレンス

エピソードの作成

リクエストアドレス: POST /v1/episodes

リクエストパラメータ

• show_id: 必須文字列
  ショー ID。
• title: 必須文字列
  エピソードのタイトル。
• description: 文字列
  エピソードの説明（オプション）。
• episode_number: 整数
  エピソード番号（オプション）。
• season_number: 整数
  シーズン番号（オプション）。
• audio_url: 文字列
  オーディオファイルの URL。authorize_UPLOAD API を使用して取得する必要があります。

レスポンス例

{
  "data": {
    "id": "123456",
    "title": "我的新剧集",
    "description": "这是一个关于播客的新剧集。",
    "episode_number": 1,
    "season_number": 1,
    "audio_url": "https://example.com/episode.mp3"
  }
}

エピソードの取得

リクエストアドレス: GET /v1/episodes/{episode_id}

パスパラメータ

• episode_id: 必須文字列
  エピソード ID。

レスポンスパラメータ

• id: 文字列
  エピソード ID。
• title: 文字列
  エピソードのタイトル。
• description: 文字列
  エピソードの説明。
• episode_number: 整数
  エピソード番号。
• season_number: 整数
  シーズン番号。
• audio_url: 文字列
  オーディオファイルの URL。

エピソードの更新

リクエストアドレス: PATCH /v1/episodes/{episode_id}

パスパラメータ

• episode_id: 必須文字列
  エピソード ID。

リクエストパラメータ

• title: 文字列
  新しいエピソードのタイトル。
• description: 文字列
  新しいエピソードの説明。
• episode_number: 整数
  新しいエピソード番号。
• season_number: 整数
  新しいシーズン番号。

レスポンス例

{
  "data": {
    "id": "123456",
    "title": "更新后的标题",
    "description": "新的描述。",
    "episode_number": 1,
    "season_number": 1
  }
}

エピソードの削除

リクエストアドレス: DELETE /v1/episodes/{episode_id}

パスパラメータ

• episode_id: 必須文字列
  エピソード ID。

レスポンス例

{
  "message": "剧集删除成功。"
}

分析データの取得

リクエストアドレス: GET /v1/analytics/episodes/{episode_id}

パスパラメータ

• episode_id: 必須文字列
  エピソード ID。

レスポンスパラメータ

• plays: 整数
  再生回数。
• unique_plays: 整数
  ユニークな再生回数。
• average_rating: 数値
  平均評価（オプション）。
• total_ratings: 整数
  総評価数。

すべてのエピソードの分析データの取得

リクエストアドレス: GET /v1/analytics/episodes

レスポンスパラメータ

• data: 配列
  各エピソードの分析データを含む配列。各オブジェクトには以下のフィールドが含まれます。
  • episode_id: 文字列
    エピソード ID。
  • title: 文字列
    エピソードのタイトル。
  • plays: 整数
    再生回数。
  • unique_plays: 整数
    ユニークな再生回数。

購読者の管理

注意: この機能はまだ実装されていません。近日公開をお楽しみに。

オーディオファイルのアップロードの承認

リクエストアドレス: POST /v1/uploads

リクエストパラメータ

• episode_title: 必須文字列
  エピソードのタイトル。
• episode_description: 文字列
  エピソードの説明（オプション）。

レスポンスパラメータ

• upload_url: 文字列
  オーディオファイルのアップロード URL。
• audio_url: 文字列
  アップロード成功後に返されるオーディオ URL。

サンプルコード

import requests

# 事前署名付き URL の取得
response = requests.post('https://api.transistor.fm/v1/uploads', json={
    'episode_title': '我的新剧集',
    'episode_description': '这是一个关于播客的新剧集。'
})
data = response.json()
upload_url = data['upload_url']

# オーディオファイルのアップロード
with open('episode.mp3', 'rb') as file:
    response = requests.put(upload_url, data=file)

認証済みユーザー情報の取得

リクエストアドレス: GET /v1/users

レスポンスパラメータ

• user_id: 文字列
  ユーザー ID。
• email: 文字列
  ユーザーのメールアドレス。

まだ実装されていない機能

• 購読者リストの取得: GET /v1/subscribers
• 購読者の作成: POST /v1/subscribers
• 購読者の更新: PATCH /v1/subscribers/{subscriber_id}
• 購読者の削除: DELETE /v1/subscribers/{subscriber_id}

⚠️ 重要提示

• すべての API リクエストには有効な API キーが必要です。
• オーディオファイルは、authorize_UPLOAD API を使用してアップロード権限を取得した後にのみ使用できます。