POST/api/global-chatbot/demo/voice-transcribe

Pretvori govorni zvočni posnetek predstavitvene strani v besedilo (Speech-to-Text), če je govor aktiviran. Predstavitveni ekvivalent za widget.voice_transcribe, trdno vezan na tržno stran Zentor namesto na gradnik najemnika.

Avtentikacija in zaščita

Avtentikacija ni potrebna

Preverjanje izvora (Origin) je trdno nastavljeno na https://zentor-app.de / https://www.zentor-app.de (ni nastavljivo, nadomestek za token gradnika na predstavitveni poti).

Idempotentno: Ne

Parametri

visitor_id(body, string, obvezno)— Mora biti veljaven UUID
audio(body, file, obvezno)— zvočna datoteka multipart/form-data

Primer odgovora

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id mora biti veljaven UUID."}}

Kode napak

400 INVALID_VISITOR_ID — visitor_id manjka ali ni veljaven UUID.
403 ORIGIN_DENIED — Izvor zahteve (Origin) ni zentor-app.de.
413 AUDIO_TOO_LARGE — Zvočna datoteka presega omejitev.
415 AUDIO_TYPE_UNSUPPORTED — Zvočni format ni podprt.

Dokaz testa v živo

Negativna primera (400 INVALID_VISITOR_ID s pravilno glavo Origin, 403 ORIGIN_DENIED) sta preverjena v živo. Uspešnega primera (prava transkripcija) zunaj produkcijske domene ni mogoče sprožiti, ker je preverjanje Origin trdno zakodirano na zentor-app.de — dokumentirano analogno kot pri widget.voice_transcribe.

← Predstavitveni chatbot in SSO