🎯 許願通報接口 REST API

📍 API Endpoint

🔗 Path

POST /webhook/get-srt-from-provider

---

📝 Request

Headers

Content-Type: application/json

JSON Body Parameters

Parameter	Type	Required	Description
youtube_id	string	✅ Yes	YouTube 影片 ID，例如 mIa47tUnV2Q
fetch_only	boolean	❌ No	是否只查詢現有字幕，不自動許願（預設為 false）

Example Request

{
  "youtube_id": "mIa47tUnV2Q",
  "fetch_only": false
}

---

✅ Response

Response JSON Structure

Field	Type	Description
status	string	可能值：
		• cached：SRT 已存在，會同時返回 url
		• not cached：SRT 不存在並且沒有在佇列中(搭配 fetch_only: true 使用)
		• queued：已加入 Whisper 許願排隊
		• forbidden：執行失敗

Example Responses

✅ SRT 已存在

{
  "status": "cached"
}

⏳ 已加入 Whisper 許願排隊

{
  "status": "queued"
}

❌ 執行失敗

{
  "status": "forbidden"
}

---

🛠️ 若 fetch_only 設為 true，且找不到字幕，將不會許願，僅回傳狀態(cached or not cached)。