POST/api/public/widget/voice-transcribe
將訪客嘅語音錄音轉為文字(語音轉文字),前提係小工具已啟用語音功能。
身份驗證同安全保障
Widget 嵌入權杖(Header X-Widget-Token)+ 來源(Origin)允許清單
冪等: 唔係
參數
widget_code(body, string,必填)audio(body, binary,必填)— 用於轉錄嘅音頻資料回應範例
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}錯誤代碼
400 WIDGET_CODE_REQUIRED — 缺少 widget_code。503 VOICE_UNAVAILABLE — 呢個小工具未啟用語音功能。即時測試證明
負例(400 欄位缺失、503 語音功能未啟用)已實時驗證。成功個案需要一個已啟用嘅語音小工具、真實音頻,以及已設定嘅語音識別供應商——未有重現。