Transistor MCP

🚀 Transistor API 中文文檔

Transistor 提供了一系列 RESTful API，可用於管理您的播客內容。藉助這些 API，您能夠輕鬆創建、更新、刪除節目，獲取分析數據，管理訂閱者，還能上傳音頻文件。

🚀 快速開始

使用 Transistor API 前，請確保您已獲取有效的 API 密鑰，因為所有 API 請求都需要它來進行身份驗證。同時，音頻文件必須先通過 authorize_UPLOAD API 獲取上傳權限後才能使用。

📚 詳細文檔

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}

💻 使用示例

基礎用法

創建劇集

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 請求都需要有效的 API 密鑰。

💡 使用建議

音頻文件必須通過 authorize_UPLOAD API 獲取上傳權限後才能使用。