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_REQUIREDwidget_code が不足しています。
503 VOICE_UNAVAILABLEこのウィジェットでは言語機能は有効化されていません。

Live-Test-Nachweis

POSTのネガティブケース(400、503)はライブで検証済み。同じパスのGETバリエーションも存在する(自動抽出によると動作は同一)、個別には再テストしていない。

チャットウィジェット