用途:通过终端驱动 Transistor.fm 账户的 v1 JSON:API,覆盖节目与单集浏览、草稿到发布的完整生命周期、每日下载分析、私密播客订阅者管理以及 webhook 注册。
主要能力:user 命令用于验证 API 密钥(GET /v1,无 /v1/user 路由);shows/show 浏览节目;episodes/episode 浏览单集,支持 --status draft 与 --include show;episode-create 始终创建草稿,episode-update 修改元数据或附加音频;episode-publish 通过专用端点切换 draft/scheduled/published;authorize-upload 处理本地音频(最大 5GB);analytics 与 episode-analytics 返回按日下载数组并汇总 downloads_total;subscribers 系列管理私密播客受众;webhooks 支持 episode_created、episode_published、subscriber_created、subscriber_deleted,每账户上限 50 个。
使用方式:在 Transistor 仪表盘 Account 页获取 API 密钥并执行 export TRANSISTOR_API_KEY="<API_KEY>"。CLI 支持 --json、--dry-run、--force、--quiet、--verbose、--help,标志可放在任意位置。典型流程为 shows 取节目 id、authorize-upload 取 audio_url、episode-create 建草稿、episode-publish 发布。
限制:请求限速 10 次/10 秒,429 会阻塞 10 秒且无重试头;分页参数为 pagination[page] 与 pagination[per],pagination[limit] 和 page[number] 会被忽略;节目资源不含计数,需从列表 meta.totalCount 推导;分析日期为 dd-mm-yyyy 且成对出现;节目创建仅限仪表盘;API 不可作为网站后端;音频处理异步,发布未处理文件会推送静音;签名上传 URL 约 600 秒过期。需 Python 3.8+ 与 requests。