Transistor.fm

🚀 電晶體 API 文檔

本 API 文檔提供了電晶體相關功能的接口信息，涵蓋劇集的創建、更新、刪除，用戶信息獲取，音頻上傳授權等操作，方便開發者進行集成和使用。

🚀 快速開始

本 API 文檔提供了一系列與電晶體相關的接口，用於管理劇集、用戶信息、音頻上傳等操作。通過調用這些 API，開發者可以實現劇集的創建、更新、刪除，獲取用戶信息，授權音頻上傳等功能。

📚 詳細文檔

創建新劇集

• API 調用：POST /v1/episodes
• 參數：
  • 必填參數：
    • show_id：劇集所屬的節目 ID
    • title：劇集標題
    • audio_url：音頻文件的 URL
  • 可選參數：
    • description：劇集描述（最多 4000 字符）
    • episode_number：劇集編號
    • season_number：季度編號
    • public：是否公開劇集 (默認為 true)
    • cover_image_url：封面圖片 URL
    • language：音頻語言（如: "zh-CN"）
    • duration：劇集時長（秒）
• 返回：新創建的劇集信息

更新現有劇集

• API 調用：PATCH /v1/episodes/:episode_id
• 參數：
  • 必填參數：
    • episode_id：需要更新的劇集 ID
  • 可選參數：
    • title：新標題
    • description：新描述（最多 4000 字符）
    • episode_number：新劇集編號
    • season_number：新季度編號
    • cover_image_url：新封面圖片 URL
    • language：新音頻語言
• 返回：更新後的劇集信息

刪除劇集

• API 調用：DELETE /v1/episodes/:episode_id
• 參數：
  • episode_id：需要刪除的劇集 ID
• 返回：狀態碼 204 (無內容)

獲取認證用戶信息

• API 調用：GET /v1/users
• 返回：當前認證用戶的詳細信息，包括：
  • 用戶 ID
  • 用戶名
  • 郵箱地址
  • 加入時間
  • 帳戶狀態

授權音頻上傳

• API 調用：POST /v1/audio-uploads
• 參數：
  • filename：將要上傳的音頻文件名稱
• 返回：
  • upload_url：音頻文件的上傳 URL（需使用此鏈接進行 PUT 請求上傳）
  • audio_url：上傳成功後，可供 API 使用的音頻 URL
  • expires_at：上傳鏈接的有效期截止時間

獲取所有劇集分析數據

• API 調用：GET /v1/analytics/episodes
• 參數：
  • show_id：過濾指定節目的劇集分析數據（可選）
  • start_date：分析開始日期（格式: "YYYY-MM-DD"，可選）
  • end_date：分析結束日期（格式: "YYYY-MM-DD"，可選）
• 返回：包含多個劇集的分析數據列表，每個劇集包括：
  • 劇集 ID
  • 標題
  • 播放次數
  • 獨特播放器數量
  • 完整播放次數
  • 平均播放時間

獲取所有節目

• API 調用：GET /v1/shows
• 返回：所有用戶創建的節目列表，包括：
  • 節目 ID
  • 標題
  • 描述
  • 創建時間
  • 更新時間

管理 Webhook 事件

添加新的 Webhook 事件

const result = await useMCPTool({
  serverName: "transistor",
  toolName: "createWebhook",
  arguments: {
    callback_url: "https://your-callback-url.com/webhook" // 必填的回調 URL
  }
});

獲取所有 Webhook 事件

const result = await useMCPTool({
  serverName: "transistor",
  toolName: "getWebhooks"
});

刪除指定 Webhook 事件

const result = await useMCPTool({
  serverName: "transistor",
  toolName: "deleteWebhook",
  arguments: {
    webhookId: "webhook-12345" // 需要刪除的 Webhook ID
  }
});

💻 使用示例

創建新劇集示例

const result = await useMCPTool({
  serverName: "transistor",
  toolName: "createEpisode",
  arguments: {
    showId: "123456", // 需要關聯的節目 ID
    title: "我的新劇集", // 劇集標題
    audioUrl: "https://your-audio-url.com/episode.mp3" // 音頻文件 URL
  }
});

🔧 技術細節

目前，以下功能尚未實現：

• 私人劇集功能：包括創建和管理私人劇集
• 高級分析功能：更詳細的播放數據統計和篩選
• 自定義域名功能：為音頻內容設置自定義域名