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

يحوّل تسجيلاً صوتيًا منطوقًا من صفحة العرض التجريبي إلى نص (تحويل الكلام إلى نص)، إذا كانت ميزة الصوت مفعّلة. النظير التجريبي لـ widget.voice_transcribe، مرتبط ثابتًا بموقع Zentor التسويقي بدلاً من Widget مستأجر.

المصادقة والأمان

لا يلزم أي مصادقة

فحص Origin ثابت على https://zentor-app.de / https://www.zentor-app.de (غير قابل للتهيئة، بديل عن Widget-Token في مسار العرض التجريبي).

متطابق القوة: لا

المعلمات

visitor_id(body, string، إلزامي)يجب أن يكون UUID صالحًا
audio(body, file، إلزامي)ملف صوتي بصيغة multipart/form-data

مثال استجابة

{"ok":false,"error":{"code":"INVALID_VISITOR_ID","message":"visitor_id muss eine gültige UUID sein."}}

رموز الأخطاء

400 INVALID_VISITOR_IDvisitor_id مفقود أو ليس UUID صالحًا.
403 ORIGIN_DENIEDأصل الطلب ليس zentor-app.de.
413 AUDIO_TOO_LARGEيتجاوز الملف الصوتي الحد المسموح.
415 AUDIO_TYPE_UNSUPPORTEDصيغة الملف الصوتي غير مدعومة.

إثبات الاختبار المباشر

تم التحقق حيًا من الحالات السلبية (400 INVALID_VISITOR_ID مع رأس Origin صحيح، 403 ORIGIN_DENIED). لا يمكن تشغيل حالة النجاح (نسخ صوتي حقيقي) خارج نطاق الإنتاج، لأن التحقق من Origin مثبت بشكل صريح على zentor-app.de — موثّق بشكل مماثل لـ widget.voice_transcribe.

روبوت الدردشة التجريبي وSSO