POST/api/public/widget/voice-speak
テキストを音声に変換(Text-to-Speech)し、ウィジェットでの音声読み上げを行います(有効化されている場合)。
Auth & Absicherung
Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste
Idempotent: Ja
Parameter
widget_code(body, string, erforderlich)text(body, string, erforderlich)— 変換対象のテキストBeispiel-Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"音声機能は現在利用できません。"}}Fehlercodes
400 WIDGET_CODE_REQUIRED — widget_code が不足しています。503 VOICE_UNAVAILABLE — このウィジェットでは言語機能は有効化されていません。Live-Test-Nachweis
POSTのネガティブケース(400、503)はライブで検証済み。同じパスのGETバリエーションも存在する(自動抽出によると動作は同一)、個別には再テストしていない。